---
title: "Add Multiple Callback Subscriptions"
method: POST
path: "/subscriptions/bulk-upsert"
tags: ["Callbacks"]
---

# Add Multiple Callback Subscriptions

`POST /subscriptions/bulk-upsert`

Create multiple callback subscriptions in a single request.

This endpoint allows you to create callback subscriptions for multiple event types and callback URLs.
Callback subscriptions are identified by the combination of event type and callback URL. If a callback subscription
with the same event type and callback URL already exists, it will be included in the response but not created again.

**Semantics:**
- Multiple callback subscriptions per event type are now allowed, as long as they have different callback URLs
- Existing callback subscriptions with matching event type and callback URL are not changed, but included in the response
- Only the callback subscriptions specified in the request are affected; other existing callback subscriptions remain unchanged
- At most 42 callback subscriptions per event type are allowed

## Request body

- object
  - `subscriptions` object[], required — List of subscriptions to create or update
    - `eventType` string, required — The event type to subscribe to (see individual callback subscription endpoints for details)
    - `callbackUrl` string, uri, required — The callback URL to which we send the callback when an event is triggered. Must be a valid and reachable HTTPS URL.

## Response `200`

Ok. Returns the affected subscriptions (both newly created and existing ones that matched).

- object
  - `subscriptions` Items[], required — unresolved $ref
  - `callbacksEnabled` boolean, required — Indicates whether callbacks are enabled for the partner

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)