Vitally

This page describes how to use Census with Vitally.

Getting Started

In this guide, we will show you how to connect Vitally to Census and create your first sync.

Prerequisites

• Have your Census account ready. If you need one, create a Free Trial Census account now.

• Have your Vitally account ready.

• Have the proper credentials to access to your data source. See our docs for each supported data source for further information:

  • Azure Synapse

  • Databricks

  • Elasticsearch

  • Google BigQuery

  • Google Sheets

  • MySQL

  • Postgres

  • Redshift

  • Snowflake

  • SQL Server

1. Copy your Vitally API Key(s)

Census makes use of different Vitally APIs for different operations. You're welcome to only connect one or the other, but we suggest connecting both in case you change your mind down the road:

Analytics API

• Required for Update or Create (a.k.a. "Upsert") and Send syncs

• Navigate to https://[your-domain].vitally.io/integrations/api

• Select Integration via HTTPS API

• Copy the API Key

Copy your Analytics API Key from Vitally.

REST API

• Required for Update Only syncs

• Navigate to https://[your-domain].vitally.io/integrations/public-api

• Copy the part of Basic Auth Header after the word Basic (e.g. if it reads Basic 1234, then only copy 1234)

Copy your REST API Key from Vitally.

2. Connect Vitally

• Return to Census and navigate to the Destinations page

• Click the New Destination button

• Select Vitally from the list

• Paste your API Key(s) into the relevant fields

• Optionally name your new connection and then click Connect

Supported Objects and Sync Behaviors

Object Name	Supported?	Sync Keys	Behavior
User	✅	User ID	Update or Create, Update Only
Account	✅	Account ID	Update or Create, Update Only
Organization	✅	Organization ID	Update or Create, Update Only
Track Event	✅	Any unique identifier	Send

Vitally defines User ID and Account ID as the unique identifier for these objects in your system. You are free to use whatever ID you like, but it needs to be unique.

Learn more about all of our sync behaviors in our Syncs documentation.

Contact us if you want Census to support more Vitally objects and/or behaviors.

User Behavior Notes

• Users must have at least one Account in Vitally so Accounts is a required field when syncing to users. It's also an Array field so you'll need to provide it an array value or JSON formatted Array.

• Any Account ID values that don't already exist in Vitally will be automatically created.

Additional Service Quirks

• Vitally's internal database has a delay between Census completing its upload and having those results reflected in the UI. This delay can be several seconds to several minutes in extreme cases.

• As with all Census syncs, when you unmap a field in Census, we will stop updating those fields. We do not delete them.

Need help connecting to Vitally?

Contact us via [e-mail] or start a conversation with us via the in-app chat.