CRcreem
Webhooks

Update a webhook endpoint

Changed on

Update the URL, name, status or event filter of a webhook endpoint. Only supplied fields change.

patch/v1/webhooks/{id}

Request

Path parameters

idstring required

The webhook ID

Request body

urlstring

The HTTPS URL Creem will deliver events to.

namestring nullable

A human-readable label for the endpoint. Send null to clear it.

status'enabled' | 'disabled'

Whether the endpoint receives deliveries. Disabled endpoints keep their configuration but receive nothing.

eventsWebhookEventType[]

Example request

{
  "url": "https://example.com/webhooks/creem",
  "name": "Production billing events"
}

Response

Successfully updated the webhook endpoint

idstring required

Unique identifier for the object.

mode'test' | 'prod' | 'sandbox' required

String representing the environment.

objectstring required

A string representing the object’s type. Objects of the same type share the same value.

store_idstring required

The store this webhook endpoint belongs to.

namestring nullable required

A human-readable label for the endpoint.

urlstring required

The HTTPS URL Creem delivers events to. For cli endpoints this is a placeholder that is never called.

delivery_mode'http' | 'cli' required

How events reach this endpoint: http deliveries are POSTed to url; cli deliveries wait in the pending-events feed for a local creem listen session.

status'enabled' | 'disabled' required

Whether the endpoint receives deliveries. Disabled endpoints keep their configuration but receive nothing.

eventsWebhookEventType[] required
secretstring

The signing secret used to verify delivery signatures. Only returned when the endpoint is created; retrieve it later via the secret endpoint.

Example response

{
  "object": "webhook",
  "store_id": "sto_1234567890",
  "name": "Production billing events",
  "url": "https://example.com/webhooks/creem",
  "events": [
    "checkout.completed",
    "subscription.paid"
  ],
  "secret": "whsec_xxxxxxxxxxxxxxxxxxxx"
}

Changes