Create webhook endpoint

Subscribe a URL to lifecycle events. The returned secret is shown only once — persist it to verify the ShortGenius-Signature of deliveries.

post/webhook_endpoints

Request

  • Base URL: https://api.shortgenius.com/v1
  • URL: https://api.shortgenius.com/v1/webhook_endpoints
  • Auth: HTTP bearer

Request body

urlstring uri required

The HTTPS URL that event payloads are delivered to.

eventsstring[] required

Event types to subscribe to. Use * to receive every event.

descriptionstring

Optional human-readable label for the endpoint.

Response

Webhook endpoint created

idstring uuid required

Unique ID of the newly created webhook endpoint.

secretstring required

The signing secret, returned exactly once. Persist it to verify the ShortGenius-Signature header of deliveries.

Changes

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