Auth type: APIDocumentation Index
Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
For general setup steps, permissions, and troubleshooting, start with: App Integrations.
Connect Klaviyo
- Go to Settings → Apps in Hyper
- Select Klaviyo → Connect New
- 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 |
| 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) |