> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeplo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact Tools

> Create, search, update, and delete contacts with the Zeplo MCP Server.

# 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:**

```json theme={null}
{
  "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:**

```json theme={null}
{
  "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` |

> [!NOTE]
>
> 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:**

```json theme={null}
{
  "query": "john",
  "limit": 10
}
```

**Response:**

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.