Webhook not receiving articles
If articles are being drafted but aren’t arriving at your site, the issue is almost always in the webhook configuration or your server’s response. Work through the steps below in order.Verify your webhook URL
Go to Settings → Integrations and confirm that your webhook URL is saved correctly. A missing trailing slash, a typo in the path, or an incorrect protocol (http vs. https) can all cause silent failures — note the URL must use
https.Check your server's response
Your server must return a 2xx HTTP status code, and respond promptly. A non-2xx response or a network/timeout error is recorded as a failed delivery, even if the article was eventually saved.
Check the last delivery status
On the webhook in Settings → Integrations, the most recent delivery status is shown inline — for example,
Last delivery: … — 200 OK or Last delivery: … — failed: <error>. Use it to tell whether the failure is a 4xx (configuration issue on your end) or a 5xx (server-side problem).Send a test payload
Use the Test webhook button in Settings → Integrations to trigger a live test. If the test fails but your URL looks correct, the problem is likely on your server or in your middleware.
SEOPilot automatically retries a failed delivery with exponential backoff — up to 5 attempts total. If every attempt fails, the delivery is marked failed. No content is ever lost: re-test with Test webhook once your endpoint is healthy, or download the article as MDX or CSV from the article view.
Articles don’t sound like my brand
Brand voice is learned from your existing site content. If articles feel generic or off-tone, the fix usually comes down to giving SEOPilot better source material or refreshing your voice profile.Check your source content volume
Make sure your site has at least 3–5 pages of original, on-brand writing before running voice detection. A homepage, an about page, and a few blog posts are enough to get started.
Update your brand voice
Go to Settings → Site information and edit the Brand voice field under Content guidance. It’s free text — describe your tone in your own words, or paste in updated guidance — and your changes guide every new article.
Edit articles that feel off
Use the built-in editor to revise any draft that doesn’t match your voice before it publishes — adjust the title, meta description, slug, or body copy.
Keywords feel too broad or too niche
SEOPilot infers your niche and audience from your site content. If the keywords it surfaces feel off, you can usually correct this by adjusting your site’s positioning copy. Keywords feel too broad: Your site may have category-level pages without enough specific positioning. Try adding more detailed product pages, use-case pages, or audience-specific landing pages so SEOPilot can identify the niche you’re targeting. Keywords feel too niche: The opposite problem — SEOPilot is picking up very narrow signals. Add some broader positioning copy to your homepage or about page so it can surface wider keyword opportunities. In both cases, you can skip any individual keyword from the dashboard by clicking the Skip button next to it, and add your own keyword or topic suggestions at any time from the dashboard.Articles aren’t appearing in Google
New articles typically appear in Google Search Console within 2–4 weeks of being published and indexed. If it’s been less than that, wait a few more days before troubleshooting further. If it’s been longer, or if your article simply isn’t showing up at all, work through the steps below.Confirm the article URL is live
Visit the article URL directly in your browser and confirm the page loads with the correct content. If it returns a 404 or redirects elsewhere, the webhook delivery or your CMS import may not have completed successfully.
Request indexing in Google Search Console
Open Google Search Console, paste the article URL into the URL Inspection tool, and click Request Indexing. This nudges Google to crawl the page sooner than it might otherwise.
Check your sitemap
Confirm that your sitemap includes the new article URL and that your sitemap is submitted in Google Search Console under Sitemaps. Dynamic or statically generated sites sometimes require a sitemap rebuild after new pages are added.