# Connect a custom site with a webhook

Source: https://distribb.io/help/publishing/connect-a-webhook
Last updated: 2026-11-05

Receive every article as JSON at your own endpoint, for any CMS or internal tool.

The API Webhook sends each article to a URL you choose, as JSON, with your access token. Use it for any CMS Distribb does not connect to directly.

## Steps

1. Open **Integrations**, choose **Add Integration**, and on the **Blog** tab choose **API Webhook**.
2. Fill in **Webhook Endpoint**: a public HTTPS URL that accepts POST requests.
3. Fill in **Access Token**: any secret string your server checks on each request.
4. Under **Test Your Webhook**, choose **Send Test Payload**. Your endpoint must answer with a 2xx status.
5. Choose **Save Integration**.

## Check it works

Your server receives a POST with event_type publish_articles and the article inside data.articles. The full field list is in the [integration docs](/docs#api-webhook), or open **View payload structure** in the same dialog.

## Good to know

- **Copy setup prompt** copies a prompt you can hand to an AI coding assistant to build the receiving endpoint.
- To send an edit, open the article, choose **Edit**, then **Update**. Distribb sends event_type update_articles to the same URL. Store the article id on first publish and use it to find the post on updates.
- Many [SaaS](/saas) teams use the webhook for a custom blog. The content is the same as on any other CMS: see the [AI content writer](/ai-content-writer).

## Go further

- [AI content writer](https://distribb.io/ai-content-writer): How Distribb researches, writes and publishes each article.
- [SaaS SEO](https://distribb.io/saas): Rankings for software companies without a content team.

Open in Distribb: https://distribb.io/integrations?add=blog