---
title: "Create event subscription"
method: POST
path: "/api/v2/events"
---

# Create event subscription

`POST /api/v2/events`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/api/v2/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/api/v2/events/post.ts> (a function with typed inputs; its response is checked against the schema)

> [!WARNING]
> This endpoint is deprecated.

Allows to subscribe an external service(callback_url) to a specific event of user or document

> [!NOTE]
> For the payload your service receives for each event, see the response examples in [Get callback info by ID](/docs/callbacks-info/operations/get-v2-dashboard-event-subscriptions-subscription-id-callbacks).

## Request body

- object
  - `event` string, required
  - `action` string
  - `entity_id` string, required
  - `attributes` object
    - `headers` object
      - `int_head` integer
      - `bool_head` boolean
      - `float_head` number
      - `string_head` string
    - `callback` string, required
    - `use_tls_12` boolean
    - `integration_id` string
    - `docid_queryparam` boolean

## Response `204`

- object

## Other responses

- `400`: * "attributes must not be empty" - "attributes" array is missing or empty * "'callback' is missing." - required parameter "callback" is missing * "Action must be equal 'callback'" - required parameter "action" is missing OR value of "action" parameter differs from 'callback' * "event must not be empty" - required parameter "event" is missing or has an empty value * "event must be string" - value of the "event" parameter is not a string * "callback must be string" - value of the "callback" parameter is not a string * "callback must be url" - value of "callback" parameter is not an URL * "Invalid integration id - {integration_id}" - value of "integration_id" parameter doesn't exist in database
- `403`: **Authorization = bearer** Request is sent with bearer token which doesn't belong user who is added to "entity_id" parameter OR Request is sent with bearer of user who is not an owner of document, added to "entity_id" parameter **Authorization = basic** Correct request which is sent by application which is not in scope of allowed ones

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)