# Klaviyo Integration {% embed url="" %} ## Log into your Existing Klaviyo Account or Create one

Create a new Klaviyo account or log into your existing one, and head to "Account Plans"

## Head to your Settings page in Klaviyo to create a new API Key

Once your inside "Account Plans" Click the "Account" tab, and choose "API keys" from the dropdown

Set your Key restrictions and Create the API Key

Copy your API key, keep this private. (Note: our example key was deleted, so it is safe to show)

## Head to the Subrise App, and go to Settings Tab

On Settings tab in Subrise app, click the "Integrations" tab.

## Paste your Klaviyo API Key

Once here, Paste your new API Key, and thats it!

## You are now connected to Klaviyo through Subrise! #### View Klaviyo Metrics

Click into Analytics > Metrics > "View Activity Feed" To see your Subrise Events

*** ## Datatypes and Events The Subrise Subscription application, will send subscription-based data to your Klaviyo account for a variety of different Events. Below are the following Events you can expect to receive data for, as well as the format of that data. ### Events * [New Subscription](#new-subscription-payload) * [New Subscriber](#new-subscriber-payload) * [Subscription Cancelled](#subscription-cancelled-payload) * [Subscription Modified](#subscription-modified) * [Upcoming Invoice](#upcoming-invoice-payload) * [Failed Transaction](#failed-transaction-payload) * [Successful Payment](#successful-payment-payload) * [Pause Subscription](#pause-subscription-payload) * [Reactivated Subscription](#reactivated-subscription-payload) * [Prepaid Subscription](#prepaid-subscription-payload) * [Addon Subscription](#addon-subscription-payload) ### New Subscription Payload ``` { metric: "subrise_new_subscription", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", subscription_line_items: [ { variant_title: blue shirt, price: 1.99, quantity: 1, discounted_price: 1.99, }, ], total_subscription_price: 1.99, subscription_started_date: "2024-05-14T17:52:47.910Z", } ``` ### New Subscriber Payload ``` { metric: "subrise_new_subscriber", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", subscription_total: 1.99, subscription_started: "2024-05-14T17:52:47.910Z", subscription_line_items: [ { variant_title: blue shirt, price: 1.99, quantity: 1, discounted_price: 1.99, }, ] } ``` ### Subscription Cancelled Payload ``` { metric: "subrise_subscription_cancelled", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", reason: "too good", reason_details: "The deal was too good", total_subscription_orders: 1, subscription_cancelled_date: "2024-05-14T17:52:47.910Z", } ``` ### Subscription Modified *updatedField, and updatedValue will correspond to the different fields that may or may not get updated on a Subscription object.* ``` { metric: "subrise_subscription_modified", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", subscription_modified_date: "2024-05-14T17:52:47.910Z", updatedField1:"deliveryInterval", updatedValue1:"MONTH", updatedField2:"deliveryIntervalCount", updatedValue2:1, updatedField3:"billingInterval". updatedValue3:"MONTH", updatedField4:"billingIntervalCount", updatedValue4:1, updatedField5:"maxCycles", updatedValue5:NULL, updatedField6:"minCycles", updatedValue6:NULL, updatedField7:"isPrepaid", updatedValue7:false, } ``` ### Upcoming Invoice Payload ``` { metric: "subrise_upcoming_invoice", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", subscription_invoice_date: "2024-05-14T17:52:47.910Z", } ``` ### Failed Transaction Payload ``` { metric: "subrise_failed_transaction", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", total_subscription_price: 1.99 failed_billing_error_message: "error", card_info: 1234, } ` ``` ### Successful Payment Payload ``` { metric: "subrise_successful_payment", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", total_subscription_price: 1.99 payment_date: "2024-05-14T17:52:47.910Z", } ``` ### Pause Subscription Payload ``` { metric: "subrise_pause_subscription", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", pause_reason: "price", pauseDetails: "Could not afford this anymore", total_subscription_orders: 3, subscription_paused_date: "2024-05-14T17:52:47.910Z" } ``` ### Reactivated Subscription Payload ```` { metric: "subrise_reactivate_sub", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", total_subscription_price: 1.99 subscription_updated_date: "2024-05-14T17:52:47.910Z" } ``` ```` ### Prepaid Subscription Payload ```` { metric: "subrise_prepaid_subscription", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", total_subscription_price: 1.99, subscription_started: "2024-05-14T17:52:47.910Z", subscription_line_items: [ { variant_title: blue shirt, price: 1.99, quantity: 1, discounted_price: 1.99, }, ] } ``` ```` ### Addon Subscription Payload ``` { metric: "subrise_addon_purchase", customer_first_name: "John", customer_last_name: "Doe", customer_email: "johndoe@test.com", customer_phone: "444-444-4444", customer_id: "12345678910" subscription_id: "12345678910", subscription_total: 1.99, subscription_started: "2024-05-14T17:52:47.910Z", addon_line_items: [ { variant_title: blue shirt, price: 1.99, quantity: 1, discounted_price: 1.99, }, ] } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.subrise.app/guide/settings/integrations/klaviyo-integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.