Activating OAuth
Before you click the "Activate OAuth" button, there are a few important things you should know.
What is OAuth?
OAuth, or "Open Authorization" is a more secure way to integrate systems that doesn't require passing and storing API keys. Klaviyo has indicated that it will eventually phase out API keys and require all integrations to use OAuth, so we're getting ahead of the game here a bit.
Using OAuth also allows us to access "webhooks" in Klaviyo so that we can be notified when someone subscribes or unsubscribes and we can update Commerce7 accordingly. We'll first do a sync to get both systems on the same page (more on that below).
What happens after I click the button?
A bunch of stuff is going to happen and some of it you may want to make some adjustments for before you click it.
The Actual Authorization
A new window will pop up from Klaviyo. If you're not logged in, it will prompt you to log in first.
If you have multiple accounts/brands, it will ask you which one you want to connect with on the next screen. Be sure to select the account that matches the account you're signed into with Commerce7.
Then you'll be asked to approve the permissions. Click the "Allow" button at the bottom of the screen.
Once it's all approved, you'll see a message saying the connection was successful and you can close that window.
The Initial Sync
Even if you're an existing user activating OAuth, the initial sync will run its course to get your opt-in status synced up.
- We go through all of your existing Klaviyo records, and if they are unsubscribed, we'll update Commerce7 to show that they unsubscribed in Klaviyo. If they are subscribed in Klaviyo and have no opt-in status set in Commerce7, we'll mark them as subscribed.
- We go through and sync all Commerce7 customers to Klaviyo, including opt-in status. If they were subscribed in Commerce7, we'll subscribe them in Klaviyo, but with a special flag that prevents double opt-in emails from firing and will not trigger any "new signup" flows. The implication here is that they subscribed a while ago and we just weren't able to sync it to Klaviyo before now.
- We sync historical events for "Placed Order", "Placed Non-Recurring Order", "Ordered Product", "Started Club Membership", and "Canceled Club Membership".
Going Forward
All customer data and events will sync from Commerce7 to Klaviyo in realtime. Importantly, we will also be syncing email consent status to Klaviyo's native consent system.
WARNING: Double opt-in is turned on by default. If you don't want your customers to receive a double opt-in message, you need to change this. You can access this setting in your Klaviyo account settings under "Account", then the "API Keys" menu. This is different than the setting you may have already changed for individual lists in Klaviyo; this is the system level setting for when people subscribe without indicating a specific list.