Set up webhooks
Get a signed HTTP POST at your endpoint when posts publish or fail, accounts change, inbox items arrive or automations run.
A webhook tells your server what happened without polling: a post published, a delivery failed, an account disconnected, and more.
Steps
Step 1: Open Webhooks
In the sidebar, open Developers, then Webhooks, and click Create Webhook.
Step 2: Enter your endpoint
Add an optional Name and the URL of your endpoint. It must start with
https://.Step 3: Set the signing secret
Leave Secret Key blank to have one generated, or enter your own of at least 16 characters.
Step 4: Add headers if your endpoint needs them
Under Custom Headers, click Add Header for each one (up to 10). Values are stored encrypted and never shown again.
Step 5: Pick events and save
Tick the Events you want, grouped by Posts, Deliveries, Accounts, Inbox and Automations, then click Create Webhook.
Step 6: Copy the secret
The signing secret is shown once. Copy it and use it to verify that each delivery came from us.
Test and troubleshoot
- Open a webhook’s menu and choose Send Test to send a test delivery to your endpoint.
- View Details lists recent Deliveries, and you can redeliver any of them.
- A failed delivery is retried automatically. After 10 failures in a row the webhook is paused; fix the endpoint, then choose Enable.
- Your endpoint should answer within 10 seconds with a 2xx status. Anything else counts as a failure.
Tips
- To rotate the secret, choose Edit and fill in Rotate Secret. The new secret is shown once.
- The webhook docs cover signature checks and the full event list.
Still stuck?
Open a ticket and someone who builds the product answers in writing.