---
schema_version: "1"
id: 21289a919b2e913902613ed1d31f339230d76dc7db278e4bff881b3cc8a1dc76
title: POST /platform/v1/ens-subscriptions
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/createSubscription.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_event_notification/createSubscription.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8c36eb565c96537d1dee0ff55efaa3fbc1a91fab5b738a68bdb9ebaf229b3812
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /platform/v1/ens-subscriptions

Creates a single subscription. A subscription indicates which event types to receive notifications for and which callback, or webhook, to receive them on. A new subscription can take up to two minutes to become active. You can create a subscription only for a verified callback and up to 200 subscriptions per callback.

## JSON Parameters

| Name                 | Type   | Description                                                                                                                                                                                                                                                                                |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `subscriptionName`   | string | Required. Name of the subscription. This name must be unique.                                                                                                                                                                                                                              |
| `callbackId`         | string | Required. Unique identifier of the callback that receives the notification events. This callback must already exist and must be verified.                                                                                                                                                  |
| `eventCategoryTypes` | array  | Required. Comma-separated list of fully qualified event types for which you’re requesting notifications. Expressed as NotificationEventCategory.NotificationEventType. Review [Supported Notification Events](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_event_notification/ens-supported-events.md) for a list of supported event categories and types. |
| `filters`            | array  | Each string in the array is a key\:value pair to filter on. Review [Subscription Filters](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_event_notification/ens-subscription-filters.md) for a list of data items available for filtering.                                                                                                                   |

## Usage

To create a subscription, send a POST request to the `/platform/v1/ens-subscriptions` endpoint.

**note:** The subscription you create is in active status, and event notifications are sent to the associated callback. Ensure that the callback you specify is ready to receive events before creating a subscription for it.

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /platform/v1/ens-subscriptions
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

[{
  "callbackId": "65b885ab-c2b4-46fe-85d0-d6cb8be8057d",
  "subscriptionName": "sub1",
  "eventCategoryTypes": ["TransactionalSendEvents.EmailNotSent",
  "TransactionalSendEvents.EmailSent"],
  "filters": ["definitionKey=12345"]
}]
```

The response contains information about the subscription.

```js
HTTP/1.1 201 Created
[{
  "callbackId": "65b885ab-c2b4-46fe-85d0-d6cb8be8057d",
  "callbackName": "cb1",
  "subscriptionName": "sub1",
  "eventCategoryTypes": ["TransactionalSendEvents.EmailNotSent",
  "TransactionalSendEvents.EmailSent"],
  "subscriptionId": "d89c87c4-70f8-43d6-be1e-f01dce97fe4c",
  "filters": ["definitionKey=12345"],
  "status": "active"
}]
```

## HTTP Responses

| Response         | Reason                                            |
| ---------------- | ------------------------------------------------- |
| 201 Created      | Subscription is created. Review example response. |
| 304 No Change    | Subscription already exists on the server.        |
| 400 Bad Request  | Invalid request                                   |
| 403 Forbidden    | Failed to pass authorization.                     |
| 404 Not Found    | Callback ID doesn't exist.                        |
| 500 Server Error | Internal error                                    |

## See Also

- [Event Notification Service](/docs/marketing/marketing-cloud/guide/ens.html)