ht
Documentation
WelcomeConcepts

Get Started

OverviewCreate a sourceCreate a modelCreate a destinationCreate a sync

Destinations

AcousticActiveCampaignAirtableAmplitudeAsanaAuth0Bing AdsBrazeChurnzeroClientSuccessCloseCustom DestinationCustomer.ioFacebook Conversions APIFacebook Custom AudiencesFacebook Offline Conversions APIFacebook Product CatalogFreshdeskFrontGainsightGainsight PXGoogle AdsGoogle Campaign ManagerGoogle SheetsHeapHubspotIntercomIterableJiraKlaviyoMailchimpMarketoMixpanelMoengageMongoDBmParticleNetsuiteNotionOneSignalOrbitOutreachPartnerstackPendoPipedrivePostgreSQLQualtricsReply.ioRoktRudderstackS3SailthruSalesforceSalesforce Marketing CloudSalesforce Marketing Cloud File DropSalesloftSegmentSendGridSFTPSlackSnapchatStripeTheTradeDesk PostbackTiktokTotangoUserflowVeroWebhookZendesk
Documentation/Destinations/Userflow
ht
Documentation

Userflow

Table of Contents
Overview
Userflow lets your whole team build customized in-app tours, checklists and surveys without code.

Overview

This integration allows you to sync to Userflow users.

Initial Setup

Upon selecting Userflow as your destination you will be prompted to input your Userflow API key.You can locate this API key within your Userflow account by navigating to Settings > API:

Syncing rows to Userflow

Hightouch currently supports syncing the following Userflow objects:
  • Users
  • Groups

Sync Modes

There are two different possible sync modes for Userflow:
  • Upsert - pushes new objects to Userflow and updates fields that change in your warehouse.
  • Updateonly updates particular fields on existing objects in Userflow. It does not add new objects.

Record Matching

Records can be matched from your source to your Userflow workspace by the user id or group id, depending on the object you are syncing.

Field Mapping

You may also sync columns from your source to Userflow's object properties. You have the option of mapping to attributes that already exist on the Userflow object, or to create new attributes for current and future use.*NOTE: Aside from groups and memberships on User objects, all other fields will be associated with the Group or User object's attributes field within Userflow.

A note on "groups" and "memberships"

The Userflow API allows you to create/update both groups and memberships through creating/updating a user by including the appropriate groups/memberships as fields on the user object in the request payload.However, please be aware that their inclusion is not required and at most only one of either groups or memberships can be set on a user per request. If your intention is only to sync group information, it may be best to sync Group objects instead.For more information on groups and memberships, including how they are properly formatted on a User object, please consult the Userflow API documentation:
  • Formatting groups for a User:
  • Formatting memberships for a User:

Pruning Memberships

Hightouch also supports the ability to prune memberships of a user upon sync through the prune_memberships property in the request payload. As per the Userflow API documentation:
"By default, the API will only update the memberships/groups that's included in the request. Existing memberships that are not included will not be removed, unless you set prune_memberships to true. Only set prune_memberships to true, if the groups or memberships list is set and contains all the groups the user belongs to. When a membership is deleted, the group itself is left intact."
When either groups or memberships are chosen to be synced to the destination, Hightouch will give you the option to toggle membership pruning on or off.*NOTE: By default, membership pruning is disabled.