Create webhook endpoint

Request

Create a new webhook for the sponsor.

Only one webhook is allowed per sponsor. The secret is returned only on creation. Store it securely - it cannot be retrieved later.

The secret is used to generate HMAC-SHA256 signatures for webhook payloads.

You can optionally specify which events to subscribe to. If not provided, the webhook will receive all available event types.

Security

APIKeyHeader

Bodyapplication/jsonrequired

urlstring, (uri), [ 1 .. 2083 ] characters(Url)required

Webhook endpoint URL (must be HTTPS in production)

eventsArray of strings or null(Events)

Any of:

List of event types to subscribe to. If not provided, subscribes to all events.

curl -i -X POST \
  https://pdp.seqino.dev/api/webhooks \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://api.example.com/webhooks/pdp",
    "events": [
      "invoice.created"
    ]
  }'

Responses

Webhook created successfully

Bodyapplication/json

webhook_idstring(Webhook Id)required

Unique webhook identifier

urlstring(Url)required

Webhook endpoint URL

secretstring(Secret)required

HMAC secret key (only returned once!)

eventsArray of strings(Events)required

Subscribed event types

created_atstring, (date-time)(Created At)required

Creation timestamp

messagestring(Message)

Success message

Default:"Webhook created successfully"

Response

{
  "webhook_id": "webhook_abc123def456",
  "url": "https://api.example.com/webhooks/pdp",
  "secret": "a1b2c3d4...64char_hex_secret",
  "events": [
    "invoice.created"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "message": "Webhook created successfully"
}