Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

All versions ->

Copy link to request setupRun requestRun
POST/v2/subscriptions

Create subscription

Enrolls a customer in a subscription. API Reference ->

Sign in
SandboxProduction

Access Tokens

Sign in to populate your access tokens from the developer dashboard Sign in

Link to section

Body

idempotency_key

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

Generate

customer_id

string

Required

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

location_id

string

Required

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

canceled_date

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

card_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

monthly_billing_anchor_date

integer(32-bit)

Beta

phases

plan_variation_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

price_override_money

source

Beta

start_date

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

tax_percentage

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

timezone

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

POST /v2/subscriptions

Response

// No response received yet.