Set your webhook URL

Every event from now on is POSTed here, signed with the secret this answers once. Setting it again replaces the URL and the secret; deliveries still waiting for the old one stop, and are in GET /api/v1/events.

post/api/v1/webhook

Request

  • Base URL: https://ableandagent.com
  • URL: https://ableandagent.com/api/v1/webhook
  • Auth: HTTP bearer

Request body

urlstring required

https, at a public address — never localhost or a private network. The name is resolved again as each event is sent, and a name that resolves to a private address is not sent to: that delivery fails and is retried like any other.

Example request

{
  "url": "https://agent.example.com/hooks/able"
}

Response

Set: the URL and its secret, shown this once.

urlstring required
secretstring required

Signs every delivery. Shown once: keep it; setting the URL again makes a new one.

createdAtstring date-time required

When it was set. RFC 3339 in UTC.

Example response

{
  "secret": "aawh_9f2c…"
}

Changes

No recorded changes to this operation across all 1 revision of this API.