---
title: "Create outbound webhook"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create outbound webhook

`POST /webhooks`

Creates an outbound webhook endpoint. The signing secret is returned only in this response.

## Request body

- object
  - `name` string, required
  - `url` string, uri, required
  - `events` OutboundWebhookEventType[] — Omit to subscribe to default email and SMS lifecycle events plus subscriber.invalid and subscriber.unsubscribed. Add email.opened, email.clicked, email.replied, subscriber.updated, sequence.finished, and sequence.failed explicitly for engagement, inbound reply, profile sync, or sequence lifecycle events. SMS events (sms.sent, sms.delivered, sms.failed, sms.opted_out) are included in the defaults.

## Response `201`

Created

- object
  - `success` boolean
  - `webhook` OutboundWebhookEndpoint
    - `id` string
    - `name` string
    - `url` string, uri
    - `status` 'enabled' | 'disabled'
    - `events` OutboundWebhookEventType[]
    - `consecutiveFailures` integer — Consecutive failed delivery attempts used for endpoint backoff.
    - `circuitOpenedAt` string, date-time, nullable
    - `circuitOpenUntil` string, date-time, nullable
    - `signingSecret` string — Returned only when creating a webhook or adding a signing secret.
    - `signingSecrets` object[] — Active signing secret metadata. Secret values are returned only once.
      - `id` string
      - `prefix` string
      - `createdAt` string, date-time
    - `lastSuccessAt` string, date-time, nullable
    - `lastFailureAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Invalid URL or event type
- `401` — Unauthorized

## Changes

- **2026-07-14** `83e7fd773745` — 1 warning, 1 info
  - added the new `poll.answered` enum value to the `webhook/events/items/` response property for the response status `201`
  - added the new `poll.answered` enum value to the request property `events/items/`
- **2026-07-10** `1b0d5fa83cd8` — 4 warning, 4 info
  - added the new `sms.delivered` enum value to the `webhook/events/items/` response property for the response status `201`
  - added the new `sms.failed` enum value to the `webhook/events/items/` response property for the response status `201`
  - added the new `sms.opted_out` enum value to the `webhook/events/items/` response property for the response status `201`
  - added the new `sms.sent` enum value to the `webhook/events/items/` response property for the response status `201`
  - …4 more
- **2026-06-21** `a7ebcc2a87e4` — 1 warning, 1 info
  - added the new `email.replied` enum value to the `webhook/events/items/` response property for the response status `201`
  - added the new `email.replied` enum value to the request property `events/items/`
- **2026-05-28** `ae4cc18ebdd9` — 1 warning, 1 info
  - added the new `subscriber.invalid` enum value to the `webhook/events/items/` response property for the response status `201`
  - added the new `subscriber.invalid` enum value to the request property `events/items/`
- …earlier changes not shown

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/webhooks/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/83e7fd773745/schema)