Skip to main content
BETA - The Event Subscriptions API is currently in beta. Endpoints and behavior may change as the feature evolves.
The Event Subscriptions API allows you to subscribe to parcel events and have them delivered to external endpoints such as webhooks or Klaviyo. This API uses a two-part model:
  • Connections define where events are delivered (e.g., a webhook URL or a Klaviyo account).
  • Subscriptions define which events are routed to a connection.

​
Supported connection types

​
Supported event types

​
Webhook authentication

When creating a webhook connection, you can configure authentication for event delivery requests. The following authentication types are supported: You can also add custom headers to webhook requests using the extra_headers field.

​
Retry behavior

When delivering events to a webhook endpoint, Sendcloud will retry failed deliveries up to 5 times using exponential backoff. A delivery is considered failed when the endpoint returns a non-2xx HTTP status code or is unreachable.

​
Testing event delivery

You can verify that your connection is configured correctly by using the Broadcast test event (/broadcast/test/{subscription_id}) endpoint. This sends a sample event payload to the connection endpoint and returns the result, including the HTTP status code and response body.