Create a signed webhook

POST/api/v1/webhooks

The request names events in events; the webhook resource returns them as event_types. A webhook created with a test key receives only sandbox events.

Bearer key, test or live

Request body

urlstring · urirequired

eventsarray of stringrequired

One of: message.received, message.sent, message.delivered, message.failed, contact.opted_out, contact.opted_in

sender_idsarray of string

Responses

201The webhook. The signing secret appears once.

422The URL or sender filter is not permitted.

Plus 400, 401, 403, 429, 503. See Errors.

PreviousList the account's webhooks NextGet a webhook

curl -X POST 'https://staging.useline.io/api/v1/webhooks' \
  -H "Authorization: Bearer $LINE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/hooks/line",
    "events": [
      "message.received",
      "message.delivered",
      "message.failed"
    ]
  }'