---
title: "Create subscription"
method: POST
path: "/v1/webhooks/subscriptions"
tags: ["Webhooks"]
---

# Create subscription

`POST /v1/webhooks/subscriptions`

## Request

- Base URL: `https://api.abm.dev`
- URL: `https://api.abm.dev/v1/webhooks/subscriptions`
- Auth: API key in header `X-API-Key`

Create a new webhook subscription. The URL will receive POST requests with event payloads.

## Request body

- object
  - `url` string, uri, required: HTTPS endpoint to receive events
  - `event_types` string[], required: Event types to subscribe to
  - `secret` string: Shared secret for HMAC signature verification
  - `is_active` boolean

## Response `201`

Subscription created

- WebhookSubscription
  - `id` string, uuid
  - `url` string, uri
  - `event_types` string[]
  - `is_active` boolean
  - `created_at` string, date-time
  - `last_triggered_at` string, date-time
  - `failure_count` integer: Consecutive delivery failures

## Other responses

- `400`: Invalid request parameters

---

[API](https://skmtc.dev/abm/apis/abm-dev-api.md) · [All operations](https://skmtc.dev/abm/apis/abm-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/abm/apis/abm-dev-api/revisions/970c68654961?raw)