Contact Tools

Full contact management with CRUD operations, search, and group filtering.

contact_list

List contacts with pagination, status, and group filtering. Parameters:

Parameter	Type	Required	Default	Description
`channelId`	string	No	—	Filter by channel ID
`status`	string	No	—	Filter by status: `active`, `blocked`, `unsubscribed`
`group`	string	No	—	Filter by contact group name
`page`	number	No	1	Page number
`limit`	number	No	20	Items per page

Example:

{
  "channelId": "ch_abc123",
  "status": "active",
  "group": "vip",
  "page": 1,
  "limit": 20
}

contact_get

Get full contact details by ID. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Contact ID

contact_create

Create a new contact. Parameters:

Parameter	Type	Required	Default	Description
`channelId`	string	Yes	—	Channel ID to associate with
`name`	string	Yes	—	Contact name
`phone`	string	Yes	—	Phone number with country code
`email`	string	No	—	Email address
`groups`	string[]	No	—	Contact groups
`tags`	string[]	No	—	Tags
`source`	string	No	`"api"`	Source: `manual`, `import`, `api`, `chatbot`
`dryRun`	boolean	No	`false`	Validate without creating

Example:

{
  "channelId": "ch_abc123",
  "name": "John Doe",
  "phone": "+1234567890",
  "email": "john@example.com",
  "groups": ["customers", "vip"],
  "tags": ["enterprise", "2026"]
}

contact_update

Update contact fields. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Contact ID
`name`	string	No	New name
`email`	string	No	New email
`groups`	string[]	No	New groups
`tags`	string[]	No	New tags
`status`	string	No	New status: `active`, `blocked`, `unsubscribed`

At least one optional field must be provided. Only the fields you include will be updated.

contact_delete

Delete a contact. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Contact ID to delete

contact_search

Search contacts by name, phone, or email. Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search term
`channelId`	string	No	—	Limit to a specific channel
`limit`	number	No	20	Max results

Example:

{
  "query": "john",
  "limit": 10
}

Response:

{
  "query": "john",
  "count": 2,
  "results": [
    {
      "id": "ct_abc123",
      "name": "John Doe",
      "phone": "+1234567890",
      "email": "john@example.com",
      "status": "active"
    }
  ]
}

Getting Started

Tools Reference

Resources

Contact Tools

Contact Tools

contact_list

contact_get

contact_create

contact_update

contact_delete

contact_search

​Contact Tools

​contact_list

​contact_get

​contact_create

​contact_update

​contact_delete

​contact_search

Contact Tools

contact_list

contact_get

contact_create

contact_update

contact_delete

contact_search