Skip to Content
Webhooks

Add a webhook endpoint

POST
/developer/webhooks

Adds a webhook endpoint to your account, at most 5. Answers the signing secret once. GetMattered POSTs a JSON event (DeveloperWebhookEvent) when one of your applications becomes landed, not_landed, needs_you or held_for_review, usually within two minutes. Each delivery carries GetMattered-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" under the endpoint secret>, plus GetMattered-Event-Id and GetMattered-Event-Type. Answer 2xx within 10 seconds. Anything else is retried after 1 minute, 5 minutes, 30 minutes, 2, 5, 10 and 24 hours, then the delivery is marked failed. The same event can arrive twice: skip an id you have seen. Free.

Authorization

DeveloperKey
headerAuthorizationBearer <gm_live_...>

A GetMattered developer API key, sent as Authorization: Bearer gm_live_....

Request Body

application/json
  1. body
url*string

Where GetMattered POSTs events. Public https only; redirects are not followed.

Formaturi
Lengthlength <= 2048

Response Body

The endpoint and its signing secret, shown this once.

application/json
  1. response

Successful API response

data*
meta?
success*true
Value intrue

Callbacks

Example Request
curl -X POST 'https://api.getmattered.com/api/v1/developer/webhooks' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "http://example.com"
}'
Example Response
{
  "data": {
    "createdAt": "string",
    "id": 1,
    "secretPrefix": "string",
    "url": "string",
    "secret": "string"
  },
  "meta": {
    "duration": 0,
    "performance": {
      "dbQueries": 0,
      "totalDbTime": 0
    },
    "requestId": "string",
    "timestamp": "2019-08-24T14:15:22Z",
    "version": "string"
  },
  "success": true
}