Vitally

This page describes how to use Census with Vitally.

๐Ÿƒโ€โ™‚๏ธ Getting Started

Prerequisites

You'll need a few different things to get started syncing data to Vitally.

1. Copy your Vitally API Key

Census uses your Vitally API key to send data. Before we can connect Census to Vitally, we need to first copy that key out of Vitally's settings page.

  1. Click the โš™๏ธ icon at the bottom of the left sidebar, select Integrations, and then Vitally Analytics API. Or navigate directly to https://[your-domain].vitally.io/integrations/api

  2. Select Integrate via HTTPS API

  3. Copy the key out of the API Key box

2. Connect Vitally

  • Once you are in Census, Navigate to Connectionsโ€‹

  • Click the Add Service button

  • Select Vitally in the list

  • Paste your API Key into the API Token field

  • Optionally name your new connection and then click Save

โ€‹

๐Ÿ—„ Supported Objects

Object Name

Supported?

Matching Keys

Create Fields

Users

โœ…

User ID only

โœ…

Accounts

โœ…

Account ID only

โœ…

Event

๐Ÿ”œ

โ€‹

โ€‹

NPS

๐Ÿ”œ

โ€‹

โ€‹

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

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 it you'll need to provide it an array value or JSON formatted Array.

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

๐Ÿ”„ Supported Sync Behaviors

Learn more about all of our sync behaviors on our Core Concept page.

Behaviors

Supported?

Objects

Update or Create

โœ…

All

Update Only

๐Ÿ”œ

All

Contact us if you want Census to support more Sync Behaviors for Vitally

๐Ÿ” 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 a couple seconds to a couple minutes in extreme cases.

๐Ÿš‘ Need help connecting to Vitally?

Contact us via [email protected] or start a conversion via the in-app chat.