Webhooks

Register webhook endpoint

Registers a URL to receive webhook events for the specified event types.

The response includes a signingSecret (base64-encoded, 32 bytes) that is returned once only. Use it to verify the X-Woop-Signature header on incoming webhook payloads.

Signature format: t=<unix>,v1=<hmac-sha256-hex> Signed payload: <unix>.<json-body>

post/webhooks

Request

  • Base URL: https://api.woopsocial.com/v1
  • URL: https://api.woopsocial.com/v1/webhooks
  • Auth: HTTP bearer

Request body

eventTypesWebhookEventType[] required

Webhook event types this endpoint should receive.

urlstring required

The HTTPS URL to POST webhook events to.

Response

Webhook endpoint registered.

createdAtstring date-time required
eventTypesWebhookEventType[] required
idstring required

Webhook endpoint identifier (int64 as string).

signingSecretstring

Base64-encoded 32-byte signing secret. Returned once on creation only.

urlstring required

Changes

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