Send campaigns with Klaviyo or any email platform

Connect your Klaviyo account to schedule your email campaigns from Pinned, and choose which lists and segments get each one. If you use another email platform, you can copy the email's HTML instead.

Before you start

• A Klaviyo account. Pinned doesn't keep a subscriber list: your subscribers stay in Klaviyo, and Klaviyo handles consent, unsubscribes and sending.
• A campaign to send. See Create an email campaign.

Connect Klaviyo

You connect Klaviyo with a private API key that you create in your Klaviyo account.

1. In the sidebar, click Campaigns.

2. Click Connect Klaviyo. The steps for creating a key open below the Klaviyo card.

   

3. In Klaviyo, open Settings → API keys and choose Create Private API Key. The Open Klaviyo API keys link opens that page.

4. Name the key “Pinned”.

5. Choose Custom Key. Give it Read access for Accounts, Lists and Segments, and Full access for Campaigns and Templates.

6. Click Create and copy the key right away. It starts with pk_.

7. Back in Pinned, paste the key into Private API key.

8. Click Save & connect.

Pinned checks the key with Klaviyo, then stores it encrypted. The key is never shown again. When the connection works, the card shows a message like “Connected to” your account name, followed by the account name and the last four characters of the key.

If Pinned ever needs more access, delete the key in Klaviyo and create a new one: Klaviyo keys can't be edited after they're made. To replace the key in Pinned, click Change key on the card.

You can also manage this connection on the Connections page.

Choose who gets the email

1. Open your campaign. The Campaigns page lists them.
2. Go to the Audience section of the campaign's details.
3. In the list below the search field, find a list or segment. Each one is marked List or Segment. To narrow the list, type in the search field. Its hint reads “Search lists and segments”.
4. Click Send to to send the campaign to it, or Exclude to leave its people out.

Someone who is in both a list you send to and one you exclude doesn't get the email, as in Klaviyo.

Your choices appear above the list under Send to: and Don't send to:. Excluded audiences are crossed out. To take an audience off, click its button again, or click the small x on its name. Clicking the other button moves it to the other side.

You can pick up to 15 audiences on each side. You need at least one list or segment to send to.

Pinned shows your lists and segments as they were a short while ago. If you just created one in Klaviyo and don't see it, click Refresh from Klaviyo.

If an audience you picked has since been deleted in Klaviyo, it stays in your choices with a warning icon. Remove it before you schedule.

Schedule in Klaviyo

Scheduling is always your own click. Nothing is scheduled automatically.

1. Make sure the campaign has a subject, a send time and an audience.
2. Click Schedule on the campaign.
3. In the Schedule in Klaviyo window, check the summary. It names the campaign, the date, time and time zone, and who it goes to and who is left out.
4. Click Schedule. To back out, click Cancel.

Pinned creates the campaign in your Klaviyo account, and Klaviyo sends it at that time.

If you see Almost ready to schedule

The Almost ready to schedule window means something still needs fixing. It lists each item. Fix them in the campaign, then try again. If the window has an Open the campaign button, click it to go straight there. Click Close or Got it to dismiss the window.

Unschedule a campaign

You can unschedule a campaign until 15 minutes before it goes out. To edit a scheduled campaign, unschedule it first.

See your audiences

The Audience tab on the Campaigns page shows your Klaviyo lists and segments in one place. It is read-only: Pinned reads their names, and your subscribers stay in Klaviyo.

1. On the Campaigns page, click the Audience tab.

   

2. Look through the Lists and Segments columns. Each shows its count.

3. To update them, click Refresh. To manage them in Klaviyo, click Open in Klaviyo.

Until you connect Klaviyo, the tab shows Your audiences live in Klaviyo instead. If your account has more than 100 lists or 100 segments, only the first 100 of each are shown.

Use a different Klaviyo account for a workspace

The key you connect on the Connections page is your default. Every workspace uses it unless it has a key of its own. If you run several brands, each workspace can send from its own Klaviyo account. See Work with workspaces and teams.

1. In the side menu, switch to the workspace.
2. Open the Campaigns page.
3. On the Klaviyo card, click Connect a different account for this workspace.
4. Create and paste a key as described above, then click Save & connect.

That key is used only for that workspace. To go back to your default account, click Disconnect on the workspace's card.

On the Connections page, Keys for other workspaces lists the keys stored for your other workspaces, including ones for workspaces you've left. Click Remove to delete one.

Disconnect Klaviyo

1. On the Klaviyo card, click Disconnect.
2. Confirm when Pinned asks.

Campaigns already scheduled stay scheduled in Klaviyo.

Send without Klaviyo

You don't need Klaviyo to design emails in Pinned. In the editor, click Export HTML to copy the whole email, or any single section. Paste it into Mailchimp or any tool that takes custom HTML. See Design emails in the builder.

Troubleshooting

Save & connect is greyed out

The key doesn't look right yet. Klaviyo private keys start with pk_ followed by letters and numbers. Copy the whole key again from Klaviyo and paste it.

The key couldn't be saved

Pinned checks every key with Klaviyo before saving it. Check that you copied the full key and that it has the access listed in the steps above. If it still fails, create a new key.

I can't switch Klaviyo accounts or disconnect

Pinned needs the key of the account a campaign was scheduled in to unschedule it or check how it went. While a campaign is scheduled in that account, Pinned won't let you switch accounts or disconnect. Unschedule the campaign, or wait until it has sent, then try again. Replacing a key with another key from the same account is always fine.

The card says Last Klaviyo call failed

Klaviyo refused the saved key, often because it was deleted or changed in Klaviyo. Click Change key and add a new one.

Klaviyo is locked on my plan

On the Free and Creator plans, the card says that email campaigns and Klaviyo scheduling are part of the Business plan. Click See the Business plan to learn more. If you connected a key earlier, it stays stored, encrypted, until you disconnect it.

Still stuck? Email support@pinned.gg.