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

  1. Step 1: Open Webhooks

    In the sidebar, open Developers, then Webhooks, and click Create Webhook.

  2. Step 2: Enter your endpoint

    Add an optional Name and the URL of your endpoint. It must start with https://.

  3. Step 3: Set the signing secret

    Leave Secret Key blank to have one generated, or enter your own of at least 16 characters.

  4. 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.

  5. Step 5: Pick events and save

    Tick the Events you want, grouped by Posts, Deliveries, Accounts, Inbox and Automations, then click Create Webhook.

  6. 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.

Signed in? Open a ticket from the dashboard.

Contact Us