Subscribe to purchase events | Andel

AuthorizationBearer

Production machine-to-machine flow. Tokens issued by Descope.

This endpoint expects an object.

urlstringRequiredformat: "uri"

HTTPS endpoint where Andel will POST events.

event_typeslist of enumsRequired

descriptionstringOptional

Human-readable label for this subscription.

Subscription created. The response includes the signing secret used to verify webhook payloads.

subscription_idstringformat: "uuid"

urlstringformat: "uri"

event_typeslist of strings

created_atdatetime

signing_secretstring

Secret used to verify the X-Andel-Signature header on webhook deliveries. Returned once at creation.

descriptionstring

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

$	curl -X POST https://api.andel.org/exchange/v1/webhooks/subscriptions \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"url": "https://example-pbm.com/webhooks/andel",
>	"event_types": [
>	"purchase.created"
>	],
>	"description": "Production purchases stream"
>	}'

1	{
2	"subscription_id": "9f1a2b3c-4d5e-6f70-8192-a3b4c5d6e7f8",
3	"url": "https://example-pbm.com/webhooks/andel",
4	"event_types": [
5	"purchase.created"
6	],
7	"created_at": "2026-05-13T18:25:00Z",
8	"signing_secret": "whsec_REPLACE_ME_AT_GO_LIVE",
9	"description": "Production purchases stream"
10	}