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

# Klaviyo

> Add profiles to Klaviyo lists

Automatically add form submitters to your Klaviyo email list.

## Setup Steps

<Steps>
  <Step title="Get Your API Key">
    1. Log in to [Klaviyo](https://klaviyo.com)
    2. Go to **Settings** → **API Keys**
    3. Create a new **Private API Key**
    4. Enable these scopes:
       * `lists:write`
       * `profiles:write`
    5. Copy the API key
  </Step>

  <Step title="Get Your List ID">
    1. Go to **Audience** → **Lists & Segments**
    2. Click on your list
    3. Go to **Settings**
    4. Copy the **List ID**
  </Step>

  <Step title="Configure in Spike">
    1. Go to your [Spike Dashboard](https://spike.ac/dashboard)
    2. Select your form → **Settings**
    3. Scroll to **Integrations** → **Klaviyo**
    4. Enable the toggle
    5. Enter your **API Key**
    6. Enter your **List ID**
    7. Save changes
  </Step>
</Steps>

## Field Mapping

| Form Field             | Klaviyo Field    |
| ---------------------- | ---------------- |
| `email`                | Email (required) |
| `name` or `first_name` | First name       |
| `last_name`            | Last name        |
| `phone`                | Phone number     |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Profiles not added">
    * Verify the API key has correct permissions
    * Check that the List ID exists
    * Ensure the email field is present
  </Accordion>

  <Accordion title="API key permissions">
    Use a Private API Key with `lists:write` and `profiles:write` scopes.
  </Accordion>
</AccordionGroup>