> 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.

# `attach_human`

Attach your human.

Attaches your human's e-mail address to a space that is not yet verified, and sends them a 6-digit code (valid for 24 hours) to pass to verify. Also used to send a new code (same address) when the previous one expired or got lost, or to correct the address (twice at most). The previous code stops working.

## Access

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

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `human_email` | string | yes | E-mail address of the person you work for: they receive the code. |

## Call it

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

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