Connect Your Klaviyo Account

Set up your Klaviyo API key and connect your brands to start uploading email templates with Grotto Slice.

Step 1: Create a Klaviyo Private API Key

1

Open Klaviyo API Settings

Log into your Klaviyo account and go to Settings → API Keys (found under the Account section in the left sidebar).

2

Create a new Private API Key

Click "Create Private API Key". Give it a descriptive name like "Grotto Slice" so you can identify it later.

3

Set the required permissions

Your API key needs the following scopes:

  • Accounts - Read - allows Grotto Slice to verify the API key
  • Images - Read/Write - allows Grotto Slice to upload email section images
  • Templates - Read/Write - allows Grotto Slice to create and update email templates

You can leave all other scopes disabled. Grotto Slice only needs these three permissions.

4

Copy the key

After creating the key, copy it immediately. Klaviyo only shows the full key once. The key starts with pk_.

Step 2: Add the Key to a Brand

1

Go to Brands

In Grotto Slice, navigate to Brands from the main menu.

2

Create or edit a Brand

Click "Add Brand" to create a new brand, or click an existing brand to edit it.

3

Paste your API key

Paste your Klaviyo Private API key into the "Klaviyo API Key" field. Also set your brand's default website URL - this is used as the fallback CTA link for email sections that don't have a specific link assigned.

4

Save

Click Save. Grotto Slice will validate the API key and confirm the connection. You're ready to upload templates.

Troubleshooting

"API key validation failed"

Double-check that you copied the full key (it should start with pk_). Make sure there are no extra spaces before or after the key. If the key was recently created, wait a minute and try again.

"Missing required permissions"

Your API key is missing a required scope. Go back to Klaviyo → Settings → API Keys, edit the key, and ensure Accounts (Read), Images (Read/Write), and Templates (Read/Write) are all enabled. Alternatively, create a new key with the correct permissions.

Templates appearing in the wrong Klaviyo account

Each Brand connects to a specific Klaviyo account via its API key. Make sure you've selected the correct Brand before uploading. If you manage multiple Klaviyo accounts, each needs its own Brand in Grotto Slice with the corresponding API key.

Frequently Asked Questions

Where do I find my Klaviyo API key?

In Klaviyo, go to Settings → API Keys (under Account). Create a new Private API key or use an existing one. The key starts with "pk_".

What permissions does the API key need?

Your key needs three scopes: Accounts (Read), Images (Read/Write), and Templates (Read/Write). Without all three, uploads will fail with a permission error.

Can I use the same API key for multiple brands?

Each brand in Grotto Slice connects to one Klaviyo account via its own API key. If you manage multiple Klaviyo accounts (e.g., for different clients), each brand needs its own key from the corresponding Klaviyo account.

What is a Brand in Grotto Slice?

A Brand represents one Klaviyo account. It stores your API key, default website URL (used as the fallback CTA link), and brand colors. You can manage brands at slice.grottodigital.com/brands.

My API key stopped working. What happened?

API keys can be revoked or expire in Klaviyo. Check your Klaviyo API Keys settings to verify the key is still active. If it was revoked, create a new one with the correct scopes and update your Brand settings.

What is the 100 image per day API limit?

Klaviyo enforces a limit of 100 image uploads per day per account. Since each email template is sliced into multiple sections (typically 5–15 images), this means you can upload roughly 7–20 emails per day depending on how many sections each design produces. If you hit this limit, wait until the next day for it to reset. Plan your uploads accordingly if you have a high volume of emails to process.