---
title: "POST /api/v3/accounts/{account_id}/webhooks/subscriptions"
method: POST
path: "/api/v3/accounts/{account_id}/webhooks/subscriptions"
tags: ["Webhooks"]
---

# POST /api/v3/accounts/{account_id}/webhooks/subscriptions

`POST /api/v3/accounts/{account_id}/webhooks/subscriptions`

## Request

- Base URL: `https://cloud.getdbt.com`
- URL: `https://cloud.getdbt.com/api/v3/accounts/{account_id}/webhooks/subscriptions`
- Auth: HTTP bearer

Create a new webhook subscription

## Path parameters

- `account_id` integer, required

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- SubscriptionRequest
  - `id` string
  - `name` string, required: Webhook name
  - `description` string: Webhook description
  - `event_types` unknown[], required: Event types that trigger this webhook. Must not be empty.
    - unknown
  - `job_ids` integer[]: Job IDs that trigger this webhook. Leave empty to trigger for all jobs.
  - `client_url` string, required: Endpoint where events are sent
  - `active` boolean, required: Whether or not this Webhook is currently active
  - `http_status_code` string: The latest HTTP status code received from the client URL. 0 indicates that the webhook has not been dispatched.
  - `dispatched_at` string: Timestamp of when the webhook was last dispatched.
  - `deactivate_reason` string: Reason for deactivation
  - `account_id` integer
  - `account_identifier` string

## Response `201`

- CreateSubscriptionResponseEnvelope
  - `data` Subscription, required
    - `id` string
    - `name` string, required: Webhook name
    - `description` string: Webhook description
    - `event_types` unknown[], required: Event types that trigger this webhook. Must not be empty.
      - unknown
    - `job_ids` integer[]: Job IDs that trigger this webhook. Leave empty to trigger for all jobs.
    - `client_url` string, required: Endpoint where events are sent
    - `active` boolean, required: Whether or not this Webhook is currently active
    - `http_status_code` string: The latest HTTP status code received from the client URL. 0 indicates that the webhook has not been dispatched.
    - `dispatched_at` string: Timestamp of when the webhook was last dispatched.
    - `deactivate_reason` string: Reason for deactivation
    - `account_id` integer
    - `account_identifier` string
  - `status` WebhookResponseStatus, required
    - `code` integer, required

## Other responses

- `404`

## Changes

- **2026-10-06** (v3) `fac88ef7e8f8`: 3 breaking
  - the `job_ids/items/` request property format changed from no format to `int64` (media type: application/json)
  - the `job_ids/items/` request property format changed from no format to `int64` (media type: application/x-www-form-urlencoded)
  - the `job_ids/items/` request property format changed from no format to `int64` (media type: multipart/form-data)
- **2026-10-06** (v3) `7d5c1b4c8d8a`: 1 breaking
  - for the `path` request parameter `account_id`, the format changed from no format to `int64`
- **2026-04-22** (v3) `ed46da9332ad`: 3 breaking
  - the `account_id` request property format changed from no format to `int64` (media type: application/json)
  - the `account_id` request property format changed from no format to `int64` (media type: application/x-www-form-urlencoded)
  - the `account_id` request property format changed from no format to `int64` (media type: multipart/form-data)

[Operation history](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/changes/api/v3/accounts/:account_id/webhooks/subscriptions/post.md)

---

[API](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2.md) - [All operations](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/revisions/2448b375ac2f?raw)