Get Webhooks | Brevo API Documentation

1 import requests 2 3 url = "https://api.brevo.com/v3/webhooks" 4 5 headers = {"api-key": "<apiKey>"} 6 7 response = requests.get(url, headers=headers) 8 9 print(response.json())

1 { 2 "webhooks": [ 3 { 4 "createdAt": "2016-07-18T12:30:09Z", 5 "description": "Webhook triggered on campaign openings", 6 "events": [ 7 "opened" 8 ], 9 "id": 9864, 10 "modifiedAt": "2016-07-18T16:00:50Z", 11 "type": "transactional", 12 "url": "https://example.domain.com/webhook/events/kzfxxxxxxxx0uyo1", 13 "auth": { 14 "token": "test-auth-token1234", 15 "type": "bearer" 16 }, 17 "batched": true, 18 "channel": "email", 19 "headers": [ 20 { 21 "key": "cf-secret", 22 "value": "test-header-value" 23 } 24 ] 25 }, 26 { 27 "createdAt": "2017-02-20T14:30:00Z", 28 "description": "Webhook triggered on campaign hard bounces", 29 "events": [ 30 "hardBounces" 31 ], 32 "id": 22770, 33 "modifiedAt": "2017-02-20T19:00:00Z", 34 "type": "marketing", 35 "url": "http://exmaple.domain.com/15kxxxxxn1", 36 "channel": "sms" 37 } 38 ] 39 }

Retrieves all webhooks from your Brevo account with filtering and sorting options.

Use this to:

Monitor webhook configurations and event handling
List webhooks by type (transactional, marketing, inbound)
Review webhook endpoints and authentication
Track webhook creation and modification history
Audit webhook event subscriptions

Key information returned:

Complete webhook details and configuration
Event types and channel subscriptions
Authentication and security settings
Webhook URLs and custom headers
Creation and modification timestamps

Retrieves all webhooks from your Brevo account with filtering and sorting options. Use this to: - Monitor webhook configurations and event handling - List webhooks by type (transactional, marketing, inbound) - Review webhook endpoints and authentication - Track webhook creation and modification history - Audit webhook event subscriptions Key information returned: - Complete webhook details and configuration - Event types and channel subscriptions - Authentication and security settings - Webhook URLs and custom headers - Creation and modification timestamps

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

typeenumOptionalDefaults to transactional

Filter on webhook type

Allowed values:

sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of webhook creation

Allowed values:

Response

Webhooks informations

webhookslist of objects

Authentication

Query parameters

Response

Errors