Home / Servers / Square API / create_subscription
CreateSubscription
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
CreateSubscription Enrolls a customer in a subscription. If you provide a card on file in the request, Square charges the card for the subscription. Otherwise, Square sends an invoice to the customer's email address.… [POST /v2/subscriptions]
Name on the gateway: square_api__create_subscription · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
idempotency_key | string | A unique string that identifies this CreateSubscription request. If you do not… |
location_id required | string | The ID of the location the subscription is associated with. |
plan_variation_id | string | The ID of the subscription plan variation created using the Catalog API. |
customer_id required | string | The ID of the customer subscribing to the subscription plan variation. |
start_date | string | The YYYY-MM-DD-formatted date to start the subscription. If it is unspecified… |
canceled_date | string | The YYYY-MM-DD-formatted date when the newly created subscription is scheduled… |
tax_percentage | string | The tax to add when billing the subscription. The percentage is expressed in… |
price_override_money | object | A custom price which overrides the cost of a subscription plan variation with… |
card_id | string | The ID of the subscriber's card to charge. If it is not specified, the… |
timezone | string | The timezone that is used in date calculations for the subscription. If unset… |
source | object | The origination details of the subscription. |
monthly_billing_anchor_date | integer | The day-of-the-month to change the billing date to. |
phases | array | array of phases for this subscription |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "square_api__create_subscription",
"arguments": {
"location_id": "…",
"customer_id": "…"
}
}Or connect the Square API server directly, which lists 308 tools including this one:
claude mcp add --transport http hj-square-api https://mcp.hjlabs.in/mcp/square-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the createsubscription tool with idempotency_key set to ….