Back to Docs

Freshpaint

On This Page

Adding a Freshpaint Integration in Variance

Freshpaint is a great way to get your customer data into Variance. Hooking up RudderStack is easy. To start, head to the Integrations > Freshpaint page in Variance.

You'll find the integrations section under your company name in the top nav

Then you'll Add a Freshpaint Connection. You can describe it in any way you want, but we suggest using the name of the RudderStack source you're going to be piping from. We recommend you use one connection per source, as you can then filter by source, but it's up to you.

Just click Add connection

On the first time you connect a Freshpaint integration we ask for a little bit of additional information about you how link users with their companies in your RudderStack data. We support whatever way you currently manage things:

  1. Use `group` call: if you already use `group` to indicate the account, then you don’t need to fill in anything. We will extract the  Account automatically, and you’re good to go.
  2. Use `identify` call with custom traits (ex. `company.id` and `company.name`): choose this option if you include some information about the Account/Company/Organization as a trait in each `identify` call. When you choose this option you'll need to let us know the name of the trait you use. For instance, if you do something like `{'company':{'id':1,'name':'Awesome Company'}}` you could add `company.id` as the Account ID trait and `company.name` as the Account Name trait.
  3. (Fallback) Use domain from the `email` trait of the `identify` call: if you don't use either of the methods above, we can extract the domain from the `email` trait and use that as the Account name.

If you have any questions at all, please reach out and we're happy to hop on a Zoom and help you get set up.

Connecting Variance in Freshpaint

Once you've added your Freshpaint integration, you'll see two pieces of data:

  1. Webhook URL
  2. API Key
Your Webhook URL and API Key

Now head over to Freshpaint Apps list, find Variance, and click Configure.

Find Variance in the apps list

From there you'll see two options. You want to click Configure next to Webhook URL & API Key.

Your Variance configuration options

Here you'll add the Webhook URL and API Key we gave you on the integrations page and click Save.

Just two bits of configuration to get data flowing

Now all `page` and `identify` events should be flowing to Variance. To add more, you just go to your Schema view and choose which events you want to send to Variance and whether or not to backfill events.

Sending events to Variance is just a flip of a switch away

Grabbing Your Identify Structure

If you aren't sure what properties you're using for identifying accounts, it's easy to go into the Freshpaint dashboard to to find the payload of a recent `identify` call.

  1. Visit Liveview
  2. Sign into your app
  3. Look for Identify event (it will have a little fingerprint)
  4. Open the event and look at the custom properties

It should look something like this:

All your identify info is there in the right sidebar
Last Updated: 
August 18, 2021