Create Customer Tool
create-customerCreates one customer directly in the selected FieldRobin business when the connection has customer-write permission. Search first to avoid creating a duplicate; reuse the idempotency key only when retrying the same request. Use to create customer in the connected business. Returns capability, status, approval_required, persisted, agent_run_id, scope, customer, result, idempotent_replay, message.
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>",
"idempotency_key": "<idempotency_key>"
},
"name": "create-customer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Customer full name. | |
| No | Customer email address, if known. | ||
| notes | No | Internal customer notes. | |
| phone | No | Customer phone number, if known. | |
| address | No | Customer address, if known. | |
| trade_type | No | Customer trade or service type. | |
| location_id | No | Business location for the customer. | |
| business_name | No | Customer business name, if known. | |
| lifecycle_tag | No | Lifecycle tag. | |
| idempotency_key | Yes | Opaque retry key. Reuse it only for the same request to receive the verified result without creating a duplicate. | |
| acquisition_source | No | How the customer was acquired. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | Yes | Business boundary used to authorize this result. | |
| result | Yes | Verified domain result and tenant-scoping evidence. | |
| status | Yes | Authoritative mutation outcome. | |
| message | Yes | Human-readable completion message. | |
| customer | Yes | Safe projection of the created record. | |
| persisted | Yes | Whether the record was persisted. | |
| capability | Yes | Executed domain capability name. | |
| agent_run_id | Yes | Auditable agent run identifier. | |
| approval_required | Yes | Whether additional approval is required. | |
| idempotent_replay | Yes | True when this repeats an already verified request. |