Bulk Create Subscriptions

post

https://api.vcita.biz/v3/license/subscriptions/bulk

Overview

Create multiple identical Subscriptions for a business in a single request. Supported for add-on offerings only (type = addon); each created subscription is a separate line (e.g., an offering of 5 staff seats with quantity = 3 results in 3 subscription lines, 15 staff seats in total).

Subscriptions are created sequentially; if one creation fails, previously created lines are kept and the error is returned.

Available for Staff tokens.

Token permissions and external payment type behavior are identical to POST /license/subscriptions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for creating multiple identical subscriptions of an add-on offering in a single request.

offering_uid

string

required

The underlying directory offering uid. Must be a valid offering_uid either from vcita or from the offering GET API.

purchase_currency

string

enum

required

The purchase currency at the moment of the subscription was created. Supported currencies: USD; EUR; GBP

Allowed:

business_cart

string

Optional. The business cart identifier to associate with this subscription.

coupon_code

string

Optional. Discount identifier used for tracking and Recurly integration. This is the coupon code that will be applied to the subscription.

price

number

Optional. The actual amount charged to the customer. When provided, this overrides the standard offering price. Important: This parameter is restricted to directory/admin tokens only. Staff tokens cannot set custom prices.

quantity

integer

required

1 to 10

Number of identical subscription lines to create for the offering (e.g., 3)

Responses

201The list of created Subscriptions

400Offering is not an add-on or quantity is out of range