Webhooks

Subscriptions

A subscription pairs a trigger with a target URL. Each delivery is signed with the subscription's signing_secret, which is returned only once when the subscription is created. See the webhooks overview for payload shape and signature verification.

POST/v1/subscriptions

Create a subscription

Registers a new webhook subscription. The response includes a signing_secret you must store, it is only ever returned at creation time and is required to verify each incoming payload.

Body parameters

Name	Type	Description
trigger_idrequired	string	The event to subscribe to. See available triggers.
target_urlrequired	string	Absolute https URL Coastline will POST to. http URLs are accepted but discouraged.

Returns

HTTP 201 Created with the subscription record, including the one-time signing_secret.

GET/v1/subscriptions

List subscriptions

Returns all active (non-revoked) subscriptions for the workspace, ordered by most recently created first. The signing_secret is never returned by this endpoint.

DELETE/v1/subscriptions/{id}

Revoke a subscription

Permanently revokes a subscription so no further deliveries will be sent. Returns HTTP 204 No Content on success. Already-revoked subscriptions also return 204.

Create

curl -X POST https://www.coastlinecrm.com/api/v1/subscriptions \
  -H "Authorization: Bearer ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "trigger_id": "opportunity.estimate_approved",
    "target_url": "https://example.com/hooks/coastline"
  }'

201 Created

{
  "id": "21fa...",
  "trigger_id": "opportunity.estimate_approved",
  "target_url": "https://example.com/hooks/coastline",
  "signing_secret": "f4a1c0b2e3...",
  "created_at": "2026-04-17T14:22:08.412Z"
}

List

curl https://www.coastlinecrm.com/api/v1/subscriptions \
  -H "Authorization: Bearer ck_live_..."

Revoke

curl -X DELETE https://www.coastlinecrm.com/api/v1/subscriptions/21fa... \
  -H "Authorization: Bearer ck_live_..."