API Reference

Webhooks

View as Markdown

View as Markdown

Copy Markdown

---

Open in Claude

Open in ChatGPT

Replace all webhooks

put/api/v2/account/webhooks

Replace all webhooks for your account. This endpoint completely replaces the existing webhook configuration.

Body ParametersExpand Collapse

webhooks: WebhookConfiguration { call_log, contact_created, globalSecret, 5 more }

call_log: optional array of string or object { url, secret }

Webhooks for call logs

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

contact_created: optional array of string

Webhooks for contact creation (URL strings only)

globalSecret: optional string

Global secret applied to all webhooks

line_assigned: optional array of string or object { url, secret }

Webhooks for line assignment

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

line_blocked: optional array of string or object { url, secret }

Webhooks for blocked lines

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

outbound: optional array of string or object { url, secret }

Webhooks for outbound messages

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

receive: optional array of string or object { url, secret }

Webhooks for inbound messages

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

secret: optional string

Legacy secret field

ReturnsExpand Collapse

status: "OK" or "ERROR"

Accepts one of the following:

"OK"

"ERROR"

message: optional string

webhooks: optional WebhookConfiguration { call_log, contact_created, globalSecret, 5 more }

Updated webhook configration (partial)

call_log: optional array of string or object { url, secret }

Webhooks for call logs

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

contact_created: optional array of string

Webhooks for contact creation (URL strings only)

globalSecret: optional string

Global secret applied to all webhooks

line_assigned: optional array of string or object { url, secret }

Webhooks for line assignment

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

line_blocked: optional array of string or object { url, secret }

Webhooks for blocked lines

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

outbound: optional array of string or object { url, secret }

Webhooks for outbound messages

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

receive: optional array of string or object { url, secret }

Webhooks for inbound messages

Accepts one of the following:

UnionMember0 = string

Simple webhook URL (HTTPS only)

WebhookObject = object { url, secret }

url: string

Webhook URL (HTTPS only)

formaturi

secret: optional string

Secret for webhook verification

secret: optional string

Legacy secret field

Replace all webhooks

HTTP

• HTTP
• TypeScript
• Python

curl https://api.sendblue.co/api/v2/account/webhooks \
    -X PUT \
    -H 'Content-Type: application/json' \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET" \
    -d '{
          "webhooks": {
            "call_log": [
              "https://example.com/call-webhook"
            ],
            "contact_created": [
              "https://example.com/contact-webhook"
            ],
            "globalSecret": "my-global-secret",
            "receive": [
              "https://example.com/webhook1",
              {
                "url": "https://example.com/webhook2",
                "secret": "webhook-secret"
              }
            ]
          }
        }'

200 example

{
  "status": "OK",
  "message": "message",
  "webhooks": {
    "call_log": [
      "https://example.com/webhook"
    ],
    "contact_created": [
      "https://example.com"
    ],
    "globalSecret": "globalSecret",
    "line_assigned": [
      "https://example.com/webhook"
    ],
    "line_blocked": [
      "https://example.com/webhook"
    ],
    "outbound": [
      "https://example.com/webhook"
    ],
    "receive": [
      "https://example.com/webhook"
    ],
    "secret": "secret"
  }
}

Returns Examples

200 example

{
  "status": "OK",
  "message": "message",
  "webhooks": {
    "call_log": [
      "https://example.com/webhook"
    ],
    "contact_created": [
      "https://example.com"
    ],
    "globalSecret": "globalSecret",
    "line_assigned": [
      "https://example.com/webhook"
    ],
    "line_blocked": [
      "https://example.com/webhook"
    ],
    "outbound": [
      "https://example.com/webhook"
    ],
    "receive": [
      "https://example.com/webhook"
    ],
    "secret": "secret"
  }
}