Create contact
Create a contact with email, phone, organization and lifecycle stage.
MCP tool vtiger_write → create_contact
write Confirm
Creates one contact, the same as + Add Contact in the Contacts module. It does not look for duplicates, so call list_contacts with query first. Returns the new record_id. Fields your Vtiger layout marks mandatory must be filled; a missing one fails with the field name. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| first_name string | string | First name. |
| last_name string required | string | Last name. |
| email string | string | Email address. |
| phone string | string | Phone number. |
| organization string | string | Organization name. An existing organization is linked. |
| lifecycle_stage string | string | Lifecycle Stage, for example Lead. |
| assigned_to string | string | Owner. Default: the signed-in user. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vtiger_write",
"arguments": {
"operation": "create_contact",
"arguments": {
"last_name": "last name"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"record_id": "1530",
"name": "Mira Okafor",
"email": "mira@okaforlegal.example",
"lifecycle_stage": "Lead",
"assigned_to": "Sam Rivera"
},
"isError": false
}