Create a mandate
mandate_createCreates a mandate and the out-of-band approval link for the owner. Never: Activate production. Free.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"delegate": "<delegate>",
"scopes": "<scopes>"
},
"name": "mandate_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scopes | Yes | What the owner allows you to do, at least one, e.g. ["intake.classify", "job.create"]. | |
| channel | No | Where the owner gets the approval link, e.g. {"type": "whatsapp", "number_e164": "+41791234567"}. Leave out to get the link back. | |
| paid_by | No | Who pays the platform fees. business (default): billed to the business. agent: from your own credit; send your jfa_ key. | |
| sandbox | No | true: a test mandate with sample data, approved at once, no fees, valid one day. The whole flow runs, payment is simulated, nothing reaches a real business. | |
| business | No | The business the owner runs, as far as you know it, e.g. {"name": "Muster Sanitär", "trade": "plumbing", "contact": "owner@example.ch"}. | |
| delegate | Yes | You, the agent: your name and optionally who built you, e.g. {"name": "Dispatch helper", "vendor": "Anthropic"}. | |
| expires_in_days | No | Days until the mandate ends, 1 to 30. |