---
title: "Create a connection webhook"
method: POST
path: "/connections/v1/webhooks"
tags: ["Connection Webhooks"]
---

# Create a connection webhook

`POST /connections/v1/webhooks`

Register an HTTPS endpoint to receive signed events for connections managed by the caller's partner (HQ) account. The signing `secret` is returned ONCE in this response and never again. Store it securely.

## Request body

- ConnectionWebhookCreate — Input serializer for POST /webhooks.
  - `event_type` 'connection.expiry_scheduled', required — * `connection.expiry_scheduled` - Expiry Scheduled
  - `callback_url` string, uri, required — HTTPS URL that signed events are POSTed to.

## Response `201`

Created. Includes the signing secret (shown once).

- ConnectionWebhookWithSecret — Output serializer for POST 201. Includes the signing secret (returned once only).
  - `id` string, uuid, required — Unique webhook identifier (UUID).
  - `event_type` 'connection.expiry_scheduled', required — * `connection.expiry_scheduled` - Expiry Scheduled
  - `callback_url` string, uri, required — HTTPS URL that signed events are POSTed to.
  - `is_active` boolean, required — Whether the webhook is active. Inactive webhooks do not receive events.
  - `created_at` string, date-time, required — ISO 8601 timestamp when the webhook was created.
  - `updated_at` string, date-time, required — ISO 8601 timestamp when the webhook was last updated.
  - `secret` string, required — Standard Webhooks signing secret (whsec_…). Shown once, at creation.

## Other responses

- `400` — Invalid request.
- `409` — An active webhook for this event type already exists.

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)