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

# Klaviyo

> Set up and use the Klaviyo integration with Hyper AI

Auth type: API

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Klaviyo

1. Go to Settings → Apps in Hyper
2. Select Klaviyo → Connect New
3. Provide your Klaviyo API key

## Common capabilities

* Segment audiences and manage email lists
* Orchestrate personalized email sequences
* Track campaign performance and engagement

## Use in Chat

Enable Klaviyo in the tool selector. Ask your agent to manage lists, create campaigns, or check performance.

## Use in Agents

Add Klaviyo to an agent's toolkits and select the connection. Mark sensitive actions as "requires approval."

## Use in Flows

Automate email sequences, audience segmentation, and campaign orchestration using Klaviyo action nodes.

## Troubleshooting

* API errors: verify your API key and account permissions
* List issues: check audience segment configuration

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                        | Description                                                                |
| ----------------------------- | -------------------------------------------------------------------------- |
| Add Member To List            | Add member(s) to a Klaviyo list by profile IDs                             |
| Create Campaign               | Create a Klaviyo campaign with defined inputs (email\|sms\|mobile\_push)   |
| Create Custom Metric          | Create a Klaviyo custom metric (typed definition with required metric\_id) |
| Create List                   | Create a new Klaviyo list in the connected account                         |
| Create Profile                | Create a Klaviyo profile                                                   |
| Create Segment                | Create a Klaviyo segment with a structured definition                      |
| Create Tag                    | Create a tag                                                               |
| Create Tag Group              | Create a tag group                                                         |
| Delete Campaign               | Delete a Klaviyo campaign by id                                            |
| Delete Custom Metric          | Delete a Klaviyo custom metric by id                                       |
| Delete Segment                | Delete a Klaviyo segment by id                                             |
| Delete Tag                    | Delete a tag by id                                                         |
| Get Account                   | Get a Klaviyo account by id                                                |
| Get Accounts                  | Retrieve the account(s) associated with the connected private API key      |
| Get Campaign                  | Get a Klaviyo campaign by id                                               |
| Get Campaign Message          | Get a single Klaviyo campaign message by id                                |
| Get Campaign Messages         | List messages for a Klaviyo campaign (with pagination)                     |
| Get Campaign Send Job         | Get a Klaviyo campaign send job by id                                      |
| Get Campaigns                 | List campaigns filtered by channel (email\|sms\|mobile\_push)              |
| Get Custom Metric             | Get a Klaviyo custom metric by id                                          |
| Get Custom Metrics            | List Klaviyo custom metrics (paginated)                                    |
| Get List                      | Get a Klaviyo list by id                                                   |
| Get Lists                     | List Klaviyo lists for the connected account                               |
| Get Lists For Profile         | List lists a profile belongs to (paginated)                                |
| Get Metric                    | Get a Klaviyo metric by id                                                 |
| Get Metrics                   | List Klaviyo metrics with optional integration filters                     |
| Get Metrics For Custom Metric | List metrics for a given custom metric (paginated)                         |
| Get Profile                   | Get a Klaviyo profile by id                                                |
| Get Profiles                  | List Klaviyo profiles (filters, sorts, additional-fields, pagination)      |
| Get Profiles For List         | List profiles for a Klaviyo list (paginated)                               |
| Get Profiles For Segment      | List profiles for a Klaviyo segment (filters, sort, pagination)            |
| Get Review                    | Get a Klaviyo review by id                                                 |
| Get Reviews                   | List Klaviyo reviews (paginated)                                           |
| Get Segment                   | Get a Klaviyo segment by id                                                |
| Get Segments                  | List Klaviyo segments (filters and pagination)                             |
| Get Tag                       | Get a single tag by id                                                     |
| Get Tag Group                 | Get a single tag group by id                                               |
| Get Tag Groups                | List tag groups (paginated)                                                |
| Get Tags                      | List tags (filters, sort, pagination)                                      |
| Send Campaign                 | Send a Klaviyo campaign (creates campaign send job)                        |
| Tag Campaigns                 | Associate a tag with one or more campaigns. Requires valid campaign IDs    |
| Tag Lists                     | Associate a tag with one or more lists. Requires valid list IDs            |
| Tag Segments                  | Associate a tag with one or more segments. Requires valid segment IDs      |
| Update Campaign               | Update a Klaviyo campaign by id                                            |
| Update Campaign Message       | Update a Klaviyo campaign message by id (email\|sms\|mobile\_push)         |
| Update Custom Metric          | Update a Klaviyo custom metric by id                                       |
| Update List                   | Update a Klaviyo list by id                                                |
| Update Profile                | Update a Klaviyo profile by id                                             |
| Update Review                 | Update a Klaviyo review status by id (supports rejection details)          |
| Update Segment                | Update a Klaviyo segment by id                                             |
| Update Tag                    | Update a tag by id (name only)                                             |
