---
title: "Create"
method: POST
path: "/event_subscriptions"
tags: ["EventSubscriptions"]
---

# Create

`POST /event_subscriptions`

Create an Event Subscription.

## Headers

- `ngrok-version` integer, required

## Request body

- EventSubscriptionCreate
  - `metadata` string — Arbitrary customer supplied information intended to be machine readable. Optional, max 4096 chars.
  - `description` string — Arbitrary customer supplied information intended to be human readable. Optional, max 255 chars.
  - `sources` EventSourceReplace[] — Sources containing the types for which this event subscription will trigger
    - `type` string — Type of event for which an event subscription will trigger
  - `destination_ids` string[] — A list of Event Destination IDs which should be used for this Event Subscription.

## Response `201`

Create an Event Subscription.

- EventSubscription
  - `id` string — Unique identifier for this Event Subscription.
  - `uri` string — URI of the Event Subscription API resource.
  - `created_at` string — When the Event Subscription was created (RFC 3339 format).
  - `metadata` string — Arbitrary customer supplied information intended to be machine readable. Optional, max 4096 chars.
  - `description` string — Arbitrary customer supplied information intended to be human readable. Optional, max 255 chars.
  - `sources` EventSource[] — Sources containing the types for which this event subscription will trigger
    - `type` string — Type of event for which an event subscription will trigger
    - `uri` string — URI of the Event Source API resource.
  - `destinations` Ref[] — Destinations to which these events will be sent
    - `id` string — a resource identifier
    - `uri` string — a uri for locating a resource

## Other responses

- `4XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.
- `5XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.

---

[API](https://skmtc.dev/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.dev/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/revisions/c697539ac350/schema)