For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Getting started
  • Email API
  • Transactional SMS
  • Transactional WhatsApp
  • Marketing Campaigns
  • Contact Management
  • Events
    • GETGet events
    • POSTCreate an event
    • POSTCreate events in batch
  • Object Management
  • Accounts and Settings
      • GETGet all webhooks
      • POSTCreate a webhook
      • GETGet a webhook details
      • PUTUpdate a webhook
      • DELDelete a webhook
      • POSTExport webhook history
  • Sales CRM
  • Conversations
  • Ecommerce
  • Loyalty
LogoLogo
Help CenterAPI KeysStatusSign In
Accounts and SettingsWebhooks

Get all webhooks

GET
https://api.brevo.com/v3/webhooks
GET
/v3/webhooks
1import { BrevoClient } from "@getbrevo/brevo";
2
3async function main() {
4    const client = new BrevoClient({
5        apiKey: "YOUR_API_KEY_HERE",
6    });
7    await client.webhooks.getWebhooks({});
8}
9main();
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      "headers": [
19        {
20          "key": "cf-secret",
21          "value": "test-header-value"
22        }
23      ]
24    },
25    {
26      "createdAt": "2017-02-20T14:30:00Z",
27      "description": "Webhook triggered on campaign hard bounces",
28      "events": [
29        "hardBounce"
30      ],
31      "id": 22770,
32      "modifiedAt": "2017-02-20T19:00:00Z",
33      "type": "marketing",
34      "url": "http://exmaple.domain.com/15kxxxxxn1"
35    }
36  ]
37}
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
Was this page helpful?
Previous

Create a webhook

Next
Built with

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

Errors

400
Bad Request Error