Alerts and Webhooks
Webhooks

Set up a webhook subscription

1min
POST
https://app.amberflo.io/webhook

Subscribe to events happening on your Amberflo account in order to receive an HTTP POST request when it happens.

The payload format is:

{
  "topic": <topic name>,
  "eventTime": <when the event happened, in milliseconds since UNIX epoch>,
  "eventId": <unique-per-topic event id>,
  "data": <data pertaining to the specific event>
}

To test your webhook setup, see the test endpoint.

Note that you can only configure one subscription per topic at the moment.

The system will make a limitted number of attempts to deliver the webhook. Each attempt is logged and can be seen using the Account Event API.

Since your endpoint may receive the same request multiple times, its logic should be idempotent.

Authentication
x-api-key
Body Parameters
body
enabled
topic
*
destinationUrl
*
transformTemplate
*
authHeader
*
extraHeaders
Responses
200
Successful response
All Of
webhook-put-request +
id
*
enabled
topic
*
destinationUrl
*
transformTemplate
*
authHeader
*
extraHeaders
createTime
updateTime