Kby Klaviyo
Subscribe profiles to marketing
Records marketing consent for up to 1,000 profiles on email, SMS, WhatsApp or push, optionally adding them to a list.
Description
If the list uses double opt-in, each profile gets a confirmation message first. Subscribing also removes unsubscribe, spam-report and user suppressions. To add profiles to a list without touching consent, use Add Profiles to List (`add_profiles_to_list`, `POST /api/lists/{id}/relationships/profiles`).
The MCP tool `subscribe_profile_to_marketing` subscribes one profile per call; the CLI and API take up to 1,000 at once.
subscribe-profiles.md
Subscribe profiles to marketing
Records marketing consent for up to 1,000 profiles on email, SMS, WhatsApp or push, optionally adding them to a list.
If the list uses double opt-in, each profile gets a confirmation message
first. Subscribing also removes unsubscribe, spam-report and user
suppressions. To add profiles to a list without touching consent, use Add
Profiles to List (add_profiles_to_list,
POST /api/lists/{id}/relationships/profiles).
The MCP tool subscribe_profile_to_marketing subscribes one profile per call;
the CLI and API take up to 1,000 at once.
Set up
Use the first option your agent supports.
MCP (official, remote)
Add this server to your agent's MCP settings, then sign in when asked.
{ "mcpServers": { "klaviyo": { "url": "https://mcp.klaviyo.com/mcp" } } }
Call the MCP tool subscribe_profile_to_marketing.
Server URL: https://mcp.klaviyo.com/mcp
CLI (official)
Install the command, then confirm it runs.
go install github.com/klaviyo/klaviyo-cli/cmd/klaviyo@latest
klaviyo --version
Run klaviyo profiles bulk-subscribe-profiles.
Set $KLAVIYO_API_KEY in your environment first (get a key: https://www.klaviyo.com/create-private-api-key).
API (official)
- Base URL: https://a.klaviyo.com
- Endpoint:
POST /api/profile-subscription-bulk-create-jobs - Auth: send the header
Authorization: Klaviyo-API-Key $KLAVIYO_API_KEY - Get a key: https://www.klaviyo.com/create-private-api-key
- Docs: https://developers.klaviyo.com/en/reference/api_overview
Before doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.