> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `subscribe`

Get the payment link.

Hands over the space's personal payment link, valid for 72 hours, to give to your human as it is. On the page, they choose their plan (€9, €19 or €49 a month), enter their billing details, then pay with Mollie and confirm with their bank; the same amount is then debited every month until cancellation. You never pay and never approve anything on their behalf. Call it when a send is refused for lack of a plan (payment_required), or when your human asks to pay, once they agree. Then billing_status tells you whether the plan is active: as soon as it is, resume what was waiting.

## Access

- **Key**: an Escouade Mail key with `read` or `send` or `approve` or `manage_inboxes`.
- **Space**: a verified space.
- **Changes nothing**: no, it acts.
- **Safe to replay**: use an `idempotency_key` where the tool offers one.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `plan` | one of `mail-9`, `mail-19`, `mail-49` | no | The plan to offer (mail-9 by default). Your human can choose another one on the page. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/subscribe \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{}'
```

The full page in French, with the response fields and every refusal the tool can return: [/mail/docs/reference/subscribe](https://escouade.io/mail/docs/reference/subscribe).