Add a client
create_clientUse this when the user says a client is new and asks to add them, or an invoice or quote needs a client that list_clients does not find. Adds a client (name and optional 15-digit UAE TRN, checked as check_trn does) to the business and returns its client_id. If a client with the same TRN or exactly the same name exists, that client is returned and nothing is created. Do not use it for a client that already exists (list_clients).
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": {
"name": "<name>"
},
"name": "create_client"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trn | No | ||
| name | Yes | ||
| business_id | No | From list_businesses. May be left out when the connection shares exactly one business. | |
| client_type | No | business or individual. | |
| idempotency_key | No | Optional. A unique string (for example a UUID) for this request: a retry with the same key returns the first result instead of writing again. |