# Subscribe a customer to a plan (https://docs.billwave.example/api-reference/attach)

Creates or switches a subscription for a customer. Handles free plans, upgrades, downgrades, and trial flows. Returns a checkout URL if payment is required.

---

## API operations

- `POST /v1/attach`

Full request and response schemas: https://docs.billwave.example/openapi.json