Webhooks
Create Webhook
Create a signed webhook endpoint
POST
Create Webhook
Creates an endpoint. The response returns the full signing secret, so store it now. The API never returns it again; you can see it again or rotate it in the app under Settings → Agents & Integrations → Webhooks.Request
Event keys the endpoint gets, such as
post.failed. See Webhooks for the list.Also send events from these workspaces, or
["*"] for every workspace you own. You must be an owner or manager of each one, and only the workspace owner can use "*".Response
Status201. The endpoint object, plus:
The https address that receives the events. An address can carry a token, so it is shown in full only when the key’s owner may edit the endpoint (
notifications edit in its workspace, and in every workspace it covers). Otherwise it is cut to the scheme and host, such as https://example.com/….The last four characters of the signing secret. The API returns the full secret only when you create the endpoint; the app can show it again.
Other workspaces whose events it also gets (
["*"] for every workspace the creator owns), or nullWhether the endpoint is on. PostSyncer turns an endpoint off after it has been failing for 3 days.