Skip to main content
PATCH
/
event-subscriptions
/
connections
/
{id}
curl --request PATCH \
  --url https://panel.sendcloud.sc/api/v3/event-subscriptions/connections/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "configuration": {
    "url": "https://example.com/webhooks/sendcloud-v2"
  }
}
'
{
  "data": {
    "id": 1,
    "type": "webhook",
    "configuration": {
      "url": "https://example.com/webhooks/sendcloud-v2",
      "auth_type": "api_key",
      "extra_headers": {
        "X-Custom-Header": "my-value"
      }
    },
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-20T14:00:00Z"
  }
}
Update the configuration of an existing connection. Only the fields provided in the request body will be updated. For example, you can update just the webhook URL or authentication settings without changing other fields.
Updating a connection’s configuration may affect all subscriptions that use this connection.

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Path Parameters

​
id
integer
required

The id of the connection.

Body

application/json

Request body for updating an existing connection. All fields are optional.

​
type
enum<string>

The type of connection.

Available options:
webhook,
klaviyo
​
configuration
object

The configuration for the connection. The shape depends on the connection type.

For webhook connections, see the webhook configuration fields. For klaviyo connections, configuration can be an empty object as credentials are managed via OAuth2.

Response

OK

Updated connection

​
data
Connection · object

A connection defines an external endpoint where event notifications are delivered.