POpolar
subscriptions
public

Create Subscription

Changed on

Create a subscription programmatically.

This endpoint only allows to create subscription on free products. For paid products, use the checkout flow.

No initial order will be created and no confirmation email will be sent.

Scopes: subscriptions:write

post/v1/subscriptions/

Request

  • Base URL
    https://api.polar.sh
  • URL
    https://api.polar.sh/v1/subscriptions/
  • Auth
    • OpenID Connect (/.well-known/openid-configuration, scopes: subscriptions:write)
    • or HTTP bearer
    • or HTTP bearer

Request body

OR

Example request

{
  "product_id": "d8dd2de1-21b7-4a41-8bc3-ce909c0cfe23",
  "customer_id": "992fae2a-2a17-4b7a-8d9e-e287cf90131b"
}

Response

Subscription created.

Subscription required(unresolved $ref)

Changes

  • f9688fd328d6Revision changes
    • info

      added the required property / to the response with the status

  • 8ae937367e87Revision changes
    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status