API Docs5 min read3 sections

Webhook Events

Configure webhooks to push events like content generation completion, successful publication, ranking anomalies, and more to your system.

1

Supported events

Webhook can be used to receive events such as SEO project generation completion, article publication success, outreach status changes, keyword ranking anomalies, and API task failures.

2

Setup Steps

Add a webhook endpoint on the API page, select the event types and save the secret. Your service must verify the signature to avoid accepting forged requests.

GoSEO / Help workflow
Webhook Events
1Analyze
2Configure
3Execute
4Check

Setup Steps

Complete the setup step by step

4 steps
1

Go to API -> Webhooks.

2

Click Add endpoint.

3

Enter the HTTPS URL.

4

Select the events you want to subscribe to.

Workflow diagram: when product screenshots are unavailable, use this flow to follow the setup steps.
  1. 1Go to API -> Webhooks.
  2. 2Click Add endpoint.
  3. 3Enter the HTTPS URL.
  4. 4Select the events you want to subscribe to.
  5. 5Save the secret and verify the signature on your server.
  6. 6Send a test event to confirm it is received correctly.
Continue to the next section when done
3

Payload example

The event payload includes event, workspaceId, resourceId, and timestamp. Different events will include a summary of the corresponding resource.

{
  "event": "campaign.article.generated",
  "workspaceId": "ws_123",
  "resourceId": "article_456",
  "timestamp": "2026-05-19T10:00:00Z"
}
Webhook Events - GoSEO Help Center | GoSEO