---
title: "POST /events/webhooks"
method: POST
path: "/events/webhooks"
tags: ["webhooks"]
---

# POST /events/webhooks

`POST /events/webhooks`

## Request

- Base URL: `https://api.e2b.app`
- URL: `https://api.e2b.app/events/webhooks`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer and API key in header `X-Team-ID`
  - API key in header `X-Admin-Token` and API key in header `X-Team-ID`
  - HTTP bearer and API key in header `X-Team-ID`

Register events webhook.

## Request body

- WebhookCreate: Configuration for registering new webhooks
  - `name` string, required
  - `url` string, uri, required
  - `events` string[], required
  - `enabled` boolean
  - `signatureSecret` string, required: Secret used to sign the webhook payloads

## Response `201`

Successfully created webhook.

- WebhookCreation: Webhook creation response
  - `id` string, required: Webhook unique identifier
  - `name` string, required: Webhook user friendly name
  - `createdAt` string, date-time, required: Time when the template was created
  - `teamId` string, required: Unique identifier for the team
  - `url` string, uri, required
  - `enabled` boolean, required
  - `events` string[], required

## Other responses

- `400`: Bad request
- `401`: Authentication error
- `404`: Not found
- `500`: Server error

## Changes

- **2026-09-18** `0fb774ca41bf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/events/webhooks/post.md)

---

[API](https://skmtc.dev/e2b-dev/apis/e2b-api.md) - [All operations](https://skmtc.dev/e2b-dev/apis/e2b-api/llms.txt) - [OpenAPI document](https://skmtc.dev/e2b-dev/apis/e2b-api/revisions/99fccbc60e6d?raw)