Import contacts
import_contactsCreate or update up to 500 contacts per call, matched by phone_number. Attributes go in fields (up to 20 strings, e.g. plan) for segments and {{field:name}} merge tags; tags group contacts. opt_in carries consent evidence (status: false records an opt-out). import_id from the first response groups several calls; dry_run: true returns what would change and writes nothing.
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": {
"contacts": "<contacts>"
},
"name": "import_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A label for the import (first request only). | |
| dry_run | No | true returns what would change and writes nothing | |
| contacts | Yes | Contacts to create or update, up to 500 per call | |
| import_id | No | From a previous response, to group several requests as one import. | |
| campaign_id | No | Applies to every opt_in row that does not name its own campaign_id | |
| check_line_types | No | dry_run only. Looks up line types to count landlines; live lookups are paid, so only the first 500 numbers are checked. |