v1

latestOpenAPI 3.1.0MIT-LICENSE2026-07-24113190543.3 KB
Subscriptions

Create Subscription

Create a new subscription for a customer (keeps existing subscriptions active)

post/customers/{customer_id}/subscriptions

Path parameters

customer_idstring required
Example:cus_2tGzG1GxtDAZHEGPH

Identifier of the customer resource

Headers

Accept-Language'es' | 'en'

Use for knowing which language to use

X-Child-Company-Idstring

In the case of a holding company, the company id of the child company to which will process the request.

Request body

plan_idstring required
card_idstring
trial_endinteger

Example request

{
  "plan_id": "f84gdgf5g48r15fd21g8w424fd1",
  "card_id": "src_2qUCNd5AyQqfPMBuV",
  "trial_end": 1484040996
}

Response

successful