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

# Create a webhook subscriptions

`POST /v1/webhooks`

Create a webhook subscriptions

## Request body

- ExternalCreateWebhookSubscriptionSchema
  - `event` 'account.created' | 'account.updated' | 'conversation.created' | 'conversation.agent' | 'conversation.tags' | 'conversation.custom_fields' | 'conversation.status' | 'conversation.priority' | 'conversation.message' | 'conversation.message.delivery_status' | 'conversation.message.deprecated' | 'customer.identify' | 'customer.created' | 'customer.updated' | 'customer.custom_fields' | 'customer.notes' | 'customer.notes.deleted' | 'session.finished' | 'sidebar.sent' | 'sidebar.received', required
  - `endpoint` string, uri, required

## Response `200`

Successful Response

- ExternalReadWebhookSubscriptionSchema
  - `id` string, uuid, required
  - `companyId` string, uuid, required
  - `event` 'account.created' | 'account.updated' | 'conversation.created' | 'conversation.agent' | 'conversation.tags' | 'conversation.custom_fields' | 'conversation.status' | 'conversation.priority' | 'conversation.message' | 'conversation.message.delivery_status' | 'conversation.message.deprecated' | 'customer.identify' | 'customer.created' | 'customer.updated' | 'customer.custom_fields' | 'customer.notes' | 'customer.notes.deleted' | 'session.finished' | 'sidebar.sent' | 'sidebar.received', required
  - `endpoint` string, uri, required
  - `endpointKey` string, required
  - `status` 'ACTIVE' | 'INACTIVE', required
  - `signingSecret` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/atlas/apis/atlas-api.md) · [All operations](https://skmtc.net/atlas/apis/atlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlas/atlas-api/versions/d121925e599d/schema)