---
title: "Creates multiple subscriptions in a single request."
method: POST
path: "/subscriptions/batch"
tags: ["subscription"]
---

# Creates multiple subscriptions in a single request.

`POST /subscriptions/batch`

Creates multiple subscriptions between source and target catalogs/layers in batch.

## Request body

- object
  - `items` CreateSubscriptionRequestBody[], required
    - `subscriptionName` string, required — The ID to use when referring to this subscription programmatically.
    - `subscriptionHrn` string — The HERE Resource Name (HRN) of subscription
    - `description` string — A detailed description of the subscription.
    - `sourceCatalog` string, required — The HERE Resource Name (HRN) of the subscription source catalog.
    - `sourceLayer` string, required — The ID of the subscription source layer.
    - `destinationCatalog` string, required — The HERE Resource Name (HRN) of the subscription destination catalog.
    - `destinationLayer` string, required — The ID of the subscription destination layer.
    - `owner` object, required — Information about the subscription's creator.
      - `creator` Creator, required
        - `id` string — The unique ID of the user or application that initially created the catalog
      - `organisation` Organisation, required
        - `id` string — The ID of the customer organisation relating to this catalog
    - `version` integer, required — Version of the subscription configuration.
    - `created` string, required — The subscription creation timestamp in ISO 8601 format.
    - `updated` string, required — The subscription's last update timestamp in ISO 8601 format.
    - `status` object, required — Subscription status information.
      - `state` 'active' | 'failed' | 'deleted', required — State: * `active` - Subscription was created successfully and is active. * `failed` - The operation failed. * `deleted` - Subscription was deleted successfully. * `disabled` - Subscription in disable state because the source catalog/layer or target catalog/layer was removed.
      - `message` string
    - `interactiveMapSubscription` object, required — Interactive map subscription.
      - `type` 'perFeature' | 'perTransaction' | 'contentChange', required — Type: * `perFeature` - Per feature interactive map subscription type. * `perTransaction` - Per transaction interactive map subscription type. * `contentChange` - Content change interactive map subscription type.

## Response `202`

Accepted - your batch request was received and is being processed.

- SubscriptionStatusToken
  - `statusToken` string, required — Token to check subscription create or delete status.

## Other responses

- `400` — Bad Request - indicates that your request failed fast validation due to an issue, such as syntax or logical errors.
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict - indicates that: * a request with the same `x-idempotency-key` but different payload already exists, * or one or more subscriptions in the request already exist.

---

[API](https://skmtc.dev/here/apis/query-api-v1.md) · [All operations](https://skmtc.dev/here/apis/query-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/query-api-v1/revisions/30e5d2645407/schema)