Get all webhooks

GET

https://api.brevo.com/v3/webhooks

GET

/v3/webhooks

import { BrevoClient } from "@getbrevo/brevo";
async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.webhooks.getWebhooks({});
}
main();

{
  "webhooks": [
    {
      "createdAt": "2016-07-18T12:30:09Z",
      "description": "Webhook triggered on campaign openings",
      "events": [
        "opened"
      ],
      "id": 9864,
      "modifiedAt": "2016-07-18T16:00:50Z",
      "type": "transactional",
      "url": "https://example.domain.com/webhook/events/kzfxxxxxxxx0uyo1",
      "auth": {
        "token": "test-auth-token1234",
        "type": "bearer"
      },
      "batched": true,
      "headers": [
        {
          "key": "cf-secret",
          "value": "test-header-value"
        }
      ]
    },
    {
      "createdAt": "2017-02-20T14:30:00Z",
      "description": "Webhook triggered on campaign hard bounces",
      "events": [
        "hardBounce"
      ],
      "id": 22770,
      "modifiedAt": "2017-02-20T19:00:00Z",
      "type": "marketing",
      "url": "http://exmaple.domain.com/15kxxxxxn1"
    }
  ]
}

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.

AuthorizationBearer

OAuth 2.0 client_credentials (machine-to-machine) grant. Exchange your app’s client_id/client_secret for a short-lived Bearer token.

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