---
title: "Create event subscription"
method: POST
path: "/v1/event_subscriptions"
tags: ["Event"]
---

# Create event subscription

`POST /v1/event_subscriptions`

Create a new event subscription.

## Request body

- object
  - `description` string — Event subscription description.
  - `disabled` boolean — Whether the event subscription is active (false) or inactive (true).
  - `event_types` EventType[] — Indicates types of events that will be sent to this subscription. If left blank, all types will be sent.
  - `url` string, uri, required — URL to which event webhooks will be sent. URL must be a valid HTTPS address.

## Response `201`

Created

- EventSubscription — A subscription to specific event types.
  - `description` string, required — A description of the subscription.
  - `disabled` boolean, required — Whether the subscription is disabled.
  - `event_types` EventType[], nullable
  - `token` string, required — Globally unique identifier.
  - `url` string, uri, required

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `422` — Unprocessable entity.
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

## Changes

> 66 revisions in range; 11 could not be searched.

- **2026-06-23** `4a935bc6e966` — 5 warning, 5 info
  - added the new `claim.created` enum value to the `event_types/items/` response property for the response status `201`
  - added the new `claim.updated` enum value to the `event_types/items/` response property for the response status `201`
  - added the new `claim_document.accepted` enum value to the `event_types/items/` response property for the response status `201`
  - added the new `claim_document.rejected` enum value to the `event_types/items/` response property for the response status `201`
  - …6 more
- **2026-05-15** `161d70ef4fdf` — 1 warning, 1 info
  - added the new `card_authorization.challenge` enum value to the `event_types/items/` response property for the response status `201`
  - added the new `card_authorization.challenge` enum value to the request property `event_types/items/`
- **2026-04-16** `28c9b43d3182` — 1 warning, 1 info
  - added the new `card_authorization.challenge_response` enum value to the `event_types/items/` response property for the response status `201`
  - added the new `card_authorization.challenge_response` enum value to the request property `event_types/items/`

[Change history](https://skmtc.dev/lithic-com/apis/lithic-developer-api/changes/v1/event_subscriptions/post.md)

---

[API](https://skmtc.dev/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.dev/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)