---
title: "Bulk create subscriptions for a specific status page"
method: POST
path: "/v1/status-pages/{statusPageId}/subscriptions/bulk"
tags: ["Status Pages", "Subscriptions"]
---

# Bulk create subscriptions for a specific status page

`POST /v1/status-pages/{statusPageId}/subscriptions/bulk`

Bulk create subscriptions for a specific status page.

## Path parameters

- `statusPageId` string, required

## Headers

- `x-checkly-account` string — Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Request body

- BulkCreateSubscriptionsPayload
  - `subscriptions` Model84[], required — The list of subscriptions to create (max 100).
    - `type` 'EMAIL', required — The type of subscription type, i.e. EMAIL.
    - `config` string, required — The configuration details for the status page subscription. These can be very different based on the type of the subscriptions.

## Response `201`

Created

- BulkCreateSubscriptionsResponse
  - `created` number, required — The number of subscriptions successfully created.
  - `skipped` number, required — The number of subscriptions skipped (already exist).
  - `status` 'PENDING' | 'VERIFIED', required — The status of the created subscriptions.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/checklyhq/apis/checkly-public-api.md) · [All operations](https://skmtc.net/checklyhq/apis/checkly-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checklyhq/checkly-public-api/revisions/87d29dc7b4fe/schema)