Skip to content
Get Started

Get webhooks

webhooks.list() -> WebhookListResponse
get/api/account/webhooks

Get all webhooks configured for the authenticated account

ReturnsExpand Collapse
class WebhookListResponse:
status: Optional[str]
webhooks: Optional[Webhooks]
global_secret: Optional[str]

Global secret applied to all webhooks

line_assigned: Optional[List[WebhooksLineAssigned]]

Webhooks for line assigned events

Accepts one of the following:
str
class WebhookConfiguration:
url: str

Webhook endpoint URL for receiving callbacks

formaturi
secret: Optional[str]

Secret for webhook signature verification

line_blocked: Optional[List[WebhooksLineBlocked]]

Webhooks for line blocked events

Accepts one of the following:
str
class WebhookConfiguration:
url: str

Webhook endpoint URL for receiving callbacks

formaturi
secret: Optional[str]

Secret for webhook signature verification

outbound: Optional[List[WebhooksOutbound]]

Webhooks for outbound message events

Accepts one of the following:
str
class WebhookConfiguration:
url: str

Webhook endpoint URL for receiving callbacks

formaturi
secret: Optional[str]

Secret for webhook signature verification

receive: Optional[List[WebhooksReceive]]

Webhooks for inbound message events

Accepts one of the following:
str
class WebhookConfiguration:
url: str

Webhook endpoint URL for receiving callbacks

formaturi
secret: Optional[str]

Secret for webhook signature verification

Get webhooks
import os
from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key=os.environ.get("SENDBLUE_API_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SENDBLUE_API_API_SECRET"),  # This is the default and can be omitted
)
webhooks = client.webhooks.list()
print(webhooks.status)
{
  "status": "OK",
  "webhooks": {
    "globalSecret": "whsec_global123",
    "line_assigned": [
      "https://example.com"
    ],
    "line_blocked": [
      "https://example.com"
    ],
    "outbound": [
      "https://example.com"
    ],
    "receive": [
      "https://example.com"
    ]
  }
}
Returns Examples
{
  "status": "OK",
  "webhooks": {
    "globalSecret": "whsec_global123",
    "line_assigned": [
      "https://example.com"
    ],
    "line_blocked": [
      "https://example.com"
    ],
    "outbound": [
      "https://example.com"
    ],
    "receive": [
      "https://example.com"
    ]
  }
}