Findable
Guides

Publishing with a webhook

Auto-send finished articles to your CMS, test the connection, and verify the signing secret.

Findable POSTs each finished article to a webhook URL you control, so articles publish without copy-paste. Set this up when you want hands-off publishing.

When to set it up

Once you have content generating and want it to flow into your CMS automatically. Until then, finished articles land in your dashboard as drafts.

Set it up

  1. Go to Settings, Publishing.
  2. Paste your webhook URL and click Save. The easiest path is a Zapier Catch Hook (see Publish to your CMS). Custom receivers work too.

Test it

After saving a URL, click Send test event. We POST a sample webhook.test payload and show the result inline: the HTTP status code, a response excerpt, and a green "delivered" badge when your receiver accepts it. Every attempt also appears under Recent deliveries. A green delivery means publishing is live, not just saved.

The signing secret

On first save we generate a per-account signing secret and sign every payload with HMAC-SHA256 in the X-Findable-Signature header (format sha256=...).

The secret sits under the "Signing secret (advanced)" disclosure, collapsed by default, because most receivers (like a Zapier Catch Hook) trust the URL and skip verification. Reveal and copy it only if you run a custom receiver and want to verify that payloads really came from Findable.

Rotating the secret breaks existing receivers until you update them with the new secret. Rotate during a quiet window.

Resend an article

To re-send a single published article (for example, to backfill one published before your webhook existed), open the article and click Send to webhook.

See the payload shape in Webhook payload.

On this page