Skip to main content
Admin or Owner access to your Klaviyo account is required to create API keys.

​
Generating a Private API Key

Generate a Private API Key from your Klaviyo account to authenticate server-side API requests.

1

Navigate to API Keys

Sign in to your Klaviyo account, click your account name in the lower left corner, select Settings.
Under the Accounts tab, click API Keys.

2

Create the key

Click Create Private API Key, enter a name (e.g., StackOne), then choose Custom Key to select specific scopes for the key.

3

Select API scopes

Enables actions: Add Categories To Catalog Item, Add Items To Catalog Category, Add Profiles To List, Assign Template To Campaign Message, Bulk Create Catalog Categories, Bulk Create Catalog Items, Bulk Create Catalog Variants, Bulk Create Coupon Codes, Bulk Create Events, Bulk Delete Catalog Categories, Bulk Delete Catalog Items, Bulk Delete Catalog Variants, Bulk Import Profiles, Bulk Update Catalog Categories, Bulk Update Catalog Items, Bulk Update Catalog Variants, Cancel Campaign Send, Clone Campaign, Clone Template, Create Back In Stock Subscription, Create Campaign, Create Catalog Category, Create Catalog Item, Create Catalog Variant, Create Client Event, Create Client Profile, Create Coupon, Create Coupon Code, Create Custom Metric, Create Event, Create Flow, Create List, Create Profile, Create Segment, Create Tag, Create Tag Group, Create Template, Create Universal Content, Create Webhook, Delete Campaign, Delete Catalog Category, Delete Catalog Item, Delete Catalog Variant, Delete Coupon, Delete Coupon Code, Delete Custom Metric, Delete Flow, Delete List, Delete Segment, Delete Tag, Delete Tag Group, Delete Template, Delete Universal Content, Delete Webhook, Get Account, Get Accounts, Get Campaign, Get Campaign IDs For Tag, Get Campaign Message, Get Campaign Recipient Estimation, Get Campaign Recipient Estimation Job, Get Catalog Category, Get Catalog Item, Get Catalog Variant, Get Coupon, Get Coupon Code, Get Custom Metric, Get Event, Get Flow, Get Flow Action, Get Flow Action Messages, Get Flow IDs For Tag, Get Flow Message, Get Flows Triggered By List, Get Flows Triggered By Metric, Get Flows Triggered By Segment, Get Form, Get Image, Get Items For Catalog Category, Get List, Get List For Bulk Import Profiles Job, Get List IDs For Tag, Get Lists For Profile, Get Messages For Campaign, Get Metric, Get Metric Property, Get Profile, Get Profiles For Bulk Import Profiles Job, Get Profiles For List, Get Profiles For Segment, Get Segment, Get Segment IDs For Tag, Get Segments For Profile, Get Tag, Get Tag Group, Get Tags For Campaign, Get Tags For Flow, Get Tags For List, Get Tags For Segment, Get Tags For Tag Group, Get Template, Get Unified Organization, Get Universal Content, Get Webhook, Get Webhook Topic, List Campaigns, List Catalog Categories, List Catalog Variants, List Coupon Codes, List Coupons, List Custom Metrics, List Events, List Flow Actions For Flow, List Flows, List Forms, List Images, List Lists, List Metrics, List Profiles, List Segments, List Tag Groups, List Tags, List Templates, List Unified Organizations, List Universal Content, List Webhook Topics, List Webhooks, Merge Profiles, Query Campaign Values, Query Flow Series, Query Flow Values, Query Metric Aggregates, Query Segment Series, Query Segment Values, Refresh Campaign Recipient Estimation, Remove Categories From Catalog Item, Remove Items From Catalog Category, Remove Profiles From List, Render Template, Request Profile Deletion, Send Campaign, Tag Campaigns, Tag Flows, Tag Lists, Tag Segments, Update Campaign, Update Campaign Message, Update Catalog Category, Update Catalog Item, Update Catalog Variant, Update Coupon, Update Coupon Code, Update Custom Metric, Update Flow Action, Update Image, Update List, Update Profile, Update Segment, Update Tag, Update Tag Group, Update Template, Update Universal Content, Update Webhook, Upload Image From URL

Select the required scopes for your use case.

4

Copy and save the key

Click Create, then copy the generated key immediately and store it securely for use later.

  • The key is shown only once — if lost, you must create a new one.
  • Format: pk_cb18d136f356aa8d88d3475fg4fdf1ca9g

​
Finding Your Public API Key (Site ID)

Only required for client-side operations such as back-in-stock subscriptions and push tokens.

1

Copy the Site ID

On the same API Keys page, find the Public API Key section at the top. Copy the Public API Key value and store it securely for use later.

​
Getting a SCIM Key (users and roles, optional)

Listing your Klaviyo team members and their roles needs a SCIM Key. Every other action works without it. The Private API Key cannot read users.

1

Check the requirements

Klaviyo offers SCIM Provisioning only after single sign-on is set up.

  • A paid Klaviyo plan
  • The Owner or Admin role in Klaviyo
  • SSO already turned on in Klaviyo with a SAML 2.0 identity provider, such as Okta, Microsoft Entra ID or OneLogin. See How to set up single sign-on.
2

Turn on SCIM Provisioning

Click your organization name in the lower left corner, then Settings > Security. Check SCIM Provisioning.

3

Copy the key

Copy the access key Klaviyo shows and paste it into the SCIM Key field. The Klaviyo-API-Key prefix is optional.

  • Klaviyo shows the key only once.
  • The key can also create and deactivate Klaviyo users. StackOne only reads with it.
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

​
Next Steps

Webhooks setup

Configure receiving Events for Klaviyo into StackOne.