Skip to main content

Integrating Klaviyo

Capabilities​

DataGrail's Klaviyo integration provides the following capabilities:

ProductCapability
Request Manager
Request TypesAccess, Deletion (Direct Contact)
Identifier CategoriesEmail

Before You Start​

To successfully configure this integration, please ensure you have sufficient privileges:

  • DataGrail User Role: Super Admin, Connections Manager
  • Klaviyo User Role: Admin

Connect to DataGrail​

DataGrail provides two methods for securely connecting Klaviyo:

OAuth Authentication​

Create an App in Klaviyo.​

  1. Log in to Klaviyo.
  2. Navigate to the Manage Apps page.
  3. Select Create App to create your new application.
  4. Name your application and securely store your Client Secret and Client ID. You won’t be able to view your client secret again, although you can generate a new one later. When you're done, select Create.
  5. After creating your app, you should get a confirmation page with help guides for submitting your app to be listed on Klaviyo's integrations directory. Click Continue to continue setting up your OAuth app.
  6. Select the required scopes for the DataGrail integration. Separate each scope with a single space.
Required Scopes
  • accounts:read
  • profiles:read
  • lists:read
  • segments:read
  • data-privacy:read
  • data-privacy:write
  1. Edit your Redirect URLs (known as Redirect URIs in OAuth): https://datagrail.io/oauth/klaviyo
  2. When you have finished setting your scopes and redirect URLs, click Save in the top right to save your changes.

Connect to DataGrail​

  1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Klaviyo.
  2. Select OAuth Authentication Type.
  3. Enter the Client ID, and Client Secret.
  4. Select your desired Asynchronous Deletion Behavior.
Klaviyo Deletion Behavior Configuration

Mark integration as complete when a deletion request is successfully submitted: The Klaviyo Integration will be marked as "complete" as soon as the deletion request is submitted to Klaviyo.

Continue processing until the deletion request is completed (default behavior): The Klaviyo Integration will show a "processing" status until the Klaviyo deletion is complete.

  1. Select Configure Integration and then select Allow when redirected.

Private Key Authentication​

Create a Klaviyo API Key​

  1. In Klaviyo, navigate to Account Settings.
  2. Under the API Keys tab, select Create Private API Key.
  3. Select Create API key.
  4. Enter a Private API Key Name.
  5. Select Custom Key, and select the required API scopes:
Required API Scopes
  • Data Privacy: Write
  • List: Read
  • Profiles: Read
  • Segments: Read
  1. Select Create
  2. Copy the newly created API Key and store it in a secure, temporary location.

Connect to DataGrail​

  1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Klaviyo.
  2. Select API Key Authentication Type.
  3. Enter the newly created API Key.
  4. Select your desired Asynchronous Deletion Behavior.
Klaviyo Deletion Behavior Configuration

Mark integration as complete when a deletion request is successfully submitted: The Klaviyo Integration will be marked as "complete" as soon as the deletion request is submitted to Klaviyo.

Continue processing until the deletion request is completed (default behavior): The Klaviyo Integration will show a "processing" status until the Klaviyo deletion is complete.

  1. Select Configure Integration.

Next Steps​

Now that you've successfully connected the integration, check out the following resources:

Troubleshooting​

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details​

Access TypeAsynchronous
Deletion TypeAsynchronous Whole Record

API Documentation​

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.

 

Need help?
If you have any questions, please reach out to your dedicated CSM or contact us at support@datagrail.io.

Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.