Webhook Endpoints API

See the Register a Webhook Endpoint guide for a setup walkthrough.

Create a Webhook Endpoint

POST /v1/webhook_endpoints

Parameter	Type	Description
url required	string	Your HTTPS endpoint URL.
enabled_events required	array	List of event types (or ["*"] for all events).
description	string	Internal label for this endpoint.

curl https://api.meridian.dev/v1/webhook_endpoints \
  -u sk_test_4eC39HqL...: \
  -d url="https://yourapp.com/webhooks/meridian" \
  -d "enabled_events[]"=payment_intent.succeeded \
  -d "enabled_events[]"=invoice.paid \
  -d description="Production payment events"

The response includes a secret field — store it immediately as it is shown only once.

Retrieve a Webhook Endpoint

GET /v1/webhook_endpoints/:id

Update a Webhook Endpoint

POST /v1/webhook_endpoints/:id

curl https://api.meridian.dev/v1/webhook_endpoints/we_EndpointId \
  -u sk_test_4eC39HqL...: \
  -d "enabled_events[]"=payment_intent.succeeded \
  -d "enabled_events[]"=charge.dispute.created

Delete a Webhook Endpoint

DELETE /v1/webhook_endpoints/:id

List Webhook Endpoints

GET /v1/webhook_endpoints