Pendo Audiences Destination
The Pendo Audiences destination allows you to sync Twilio Engage audiences to Pendo Segments. For more information, visit Pendo's documentation.
When you create an audience in Engage and connect it to the Pendo Audiences destination, Segment automatically:
- Creates a new Segment in Pendo using the audience name.
- Adds visitors to the Pendo Segment when they enter the audience.
- Removes visitors from the Pendo Segment when they exit the audience.
Real-time to batch destination sync frequency
Real-time audience syncs may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.
Before you begin, make sure you have:
- A Pendo Integration Key, which you can find in Pendo under Settings > Integrations > Integration Keys.
- An Engage Audience that you want to connect to this destination.
- In Segment, navigate to Engage > Engage Settings.
- Click Destinations, then Add Destination.
- Search for Pendo Audiences and select the Pendo Audiences destination.
- Click Add destination, then click Confirm Source.
- Under Basic Settings, enter:
- A name for your destination (for example, "Pendo Audiences Prod").
- Your Pendo Integration Key.
- Enable the destination and click Save.
- Navigate to Connections > Destinations, search for the Pendo Audiences destination you created, and click on it.
- Navigate to Mappings > New Mapping and click the Sync Audience tile.
- Review the default field mappings. Segment automatically maps the Visitor ID field to
$.userId. Update this if your Pendo visitors are identified by a different field. - Click Save.
- On the Mappings tab, enable the Sync Audience action.
- Navigate to Engage > Audiences and select the Audience you want to sync to Pendo.
- Click Add Destination and select the Pendo Audiences destination you created.
- Configure the per-audience settings:
- Pendo Segment Name (optional): Override the name used when creating the Pendo Segment. By default, Segment maps this field to the Engage audience name.
- Click Save, then click Add 1 Destination. Your audience begins syncing to Pendo.
This destination processes Identify and Track calls emitted by Engage. Both are handled the same way — the payload is inspected to determine whether the visitor should be added to or removed from the Pendo Segment. If using Track, the event name is ignored.
Segment maps Pendo's Visitor ID field to $.userId by default. This must match the visitor ID used in your Pendo installation. You can update the mapping in the Sync Audience action if your Pendo visitors are identified by a different field.
Yes. By default Segment uses the Engage audience name when creating the Pendo Segment. You can override this on a per-audience basis using the Pendo Segment Name field in the destination's settings.
Yes. By default, events are batched and synced to Pendo using the batch PATCH endpoint, with up to 1000 visitors per request. Batching is enabled by default and can be configured in the Sync Audience action mapping.