`klaviyo_list_profiles`

Pack: klaviyo · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/klaviyo_list_profiles for the schema, then POST the same URL with its arguments for the data.

Search contacts by email, name, or custom attributes. Returns profile IDs, emails, names, and properties with pagination support.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Klaviyo private API key
`filter`	string	no	Filter string in Klaviyo filter syntax (e.g., “equals(email,\“[email protected]\”)“)
`page_size`	number	no	Number of profiles per page (default 20, max 100)

Example call

Arguments

{
  "_apiKey": "your-klaviyo-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/klaviyo/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"klaviyo_list_profiles","arguments":{"_apiKey":"your-klaviyo-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('klaviyo_list_profiles', {
  "_apiKey": "your-klaviyo-api-key"
});

More examples

{
  "_apiKey": "your-klaviyo-api-key",
  "filter": "equals(email,\"[email protected]\")",
  "page_size": 50
}

Response shape

Field	Type	Description
`data`	array	Array of profile objects
`links`	object	Pagination links

Full JSON Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "Array of profile objects",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Resource type (profile)"
          },
          "id": {
            "type": "string",
            "description": "Profile ID"
          },
          "attributes": {
            "type": "object",
            "description": "Profile attributes",
            "properties": {
              "email": {
                "type": "string",
                "description": "Contact email address"
              },
              "first_name": {
                "type": "string",
                "description": "Contact first name"
              },
              "last_name": {
                "type": "string",
                "description": "Contact last name"
              },
              "phone_number": {
                "type": "string",
                "description": "Contact phone number"
              },
              "properties": {
                "type": "object",
                "description": "Custom properties"
              }
            }
          }
        }
      }
    },
    "links": {
      "type": "object",
      "description": "Pagination links",
      "properties": {
        "self": {
          "type": "string",
          "description": "Self link"
        },
        "next": {
          "type": "string",
          "description": "Next page link"
        },
        "prev": {
          "type": "string",
          "description": "Previous page link"
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the klaviyo pack

{
  "mcpServers": {
    "klaviyo": {
      "url": "https://gateway.pipeworx.io/klaviyo/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

klaviyo_list_profiles