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

# Create webhook

`POST /webhooks`

Make an API call to this endpoint to subscribe to a webhook.

Events are a collection of strings of the following types:
* `sms.subscribed`
* `sms.sent`
* `sms.message_link_click`
* `email.subscribed`
* `email.unsubscribed`
* `email.message_link_click`
* `email.opened`
* `custom_attribute.set`

Event types are case sensitive.

All events included will be sent to the URL.

## Request body

- CreateWebhookRequestDto
  - `url` string — The destination url of the webhook
  - `events` string[] — The list of events this webhook is subscribed to

## Response `201`

Webhook has been created

- CreateWebhookResponseDto
  - `id` string — The id of the installed webhook
  - `url` string — The destination url of the webhook
  - `events` string[] — The list of events this webhook is subscribed to
  - `type` string — The type of webhook; can be either `INSTALLED` or `CREATOR`
  - `disabledAt` string — (optional) Date (YYYY-MM-DD hh:mm:ss) of when the webhook was deleted if it was deleted

## Other responses

- `400` — Invalid parameter in request query or body
- `401` — Unauthorized
- `403` — Access Denied
- `404` — The specified resource was not found
- `500` — Internal Server Error

---

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