---
title: "Create email subscription events"
method: POST
path: "/api/v2/bulk/notifications/subscriptions"
tags: ["Subscriptions"]
---

# Create email subscription events

`POST /api/v2/bulk/notifications/subscriptions`

## Request

- Base URL: `https://app.360learning.com`
- URL: `https://app.360learning.com/api/v2/bulk/notifications/subscriptions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v2/oauth2/token`

> 🔑
>
> Required OAuth scope: `subscriptions:bulk`.

> 🚜
>
> This endpoint processes up to 20,000 objects asynchronously. For more information, see the [Bulk operations guide](doc:bulk-operations-1).

Creates multiple email subscription events. Upon submission, the request is queued. Use the provided URL in the response header to check the status of the bulk operation.

## Headers

- `360-api-version` 'v2.0', required

## Request body

- CreateSubscriptionEventsBody
  - `input` SubscriptionEventDTO[], required: An array of email subscription events for users.
    - `mail` string, required: The email address of the user.
    - `type` 'activation' | 'deactivation', required: The type of subscription event to create.

## Response `202`

The operation is successfully created.

## Other responses

- `400`: The server cannot or will not process the request due to something that is perceived to be a client error.
- `401`: The given access token is either missing, invalid, has expired, or has been revoked.
- `403`: The given access token does not have the required OAuth scope to execute the request.
- `429`: The maximum number of concurrent operations has been reached.
- `503`: The bulk API is temporarily disabled.

---

[API](https://skmtc.dev/360learning/apis/bulk-api.md) - [All operations](https://skmtc.dev/360learning/apis/bulk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/360learning/apis/bulk-api/revisions/375f9b05b456?raw)