# ActiveCampaign list contacts

`activecampaign__list_contacts`

## Access

Requires a project integration connection for `activecampaign`.

**Call type:** Can read or manage credentials.

## Arguments

| Field     | Type     | Required | Description and constraints                                                                                                        |
| --------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `account` | `string` | Yes      | ActiveCampaign account subdomain: the 'youraccount' part of <https://youraccount.api-us1.com>, shown under My Settings → Developer |
| `email`   | `string` | No       | Return only the contact with this exact email                                                                                      |
| `search`  | `string` | No       | Search contacts by name, email, or phone                                                                                           |
| `limit`   | `number` | No       | Maximum contacts to return (max 100)                                                                                               |
| `offset`  | `number` | No       | Number of contacts to skip for pagination                                                                                          |

## Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See [MCP client setup](/docs/cloud/getting-started/connect-mcp.md).

```json title="request.json"
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "activecampaign__list_contacts",
    "arguments": {
      "account": "example"
    }
  }
}
```

## Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and `isError`; do not assume a fixed object shape. See the [activecampaign integration reference](/docs/cloud/apis/integrations.md) for provider setup and tool context.

## Full schemas

```json title="input-schema.json"
{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "description": "ActiveCampaign account subdomain: the 'youraccount' part of https://youraccount.api-us1.com, shown under My Settings → Developer"
    },
    "email": {
      "type": "string",
      "description": "Return only the contact with this exact email"
    },
    "search": {
      "type": "string",
      "description": "Search contacts by name, email, or phone"
    },
    "limit": {
      "type": "number",
      "description": "Maximum contacts to return (max 100)"
    },
    "offset": {
      "type": "number",
      "description": "Number of contacts to skip for pagination"
    }
  },
  "required": [
    "account"
  ],
  "description": "Arguments for the activecampaign__list_contacts tool."
}
```
