# Pendo

## Initial Setup

Navigate to Settings > Integrations > Integration Keys and create an Integration Key for Hightouch with "Allow writes" access.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MXmiWh4Cgjj84lEkLL3%2F-MXmjt0m0fdFCtU_sGMz%2Fimage.png?alt=media\&token=a08aec45-4d70-475e-96f7-5685e6f84a8b)

## Update visitors and accounts

The Pendo integration allows users to update existing visitors and accounts with metadata (both agent and custom fields).

### Matching query results to Pendo profiles

You have to choose how to match records from your model to objects in Pendo. Select a column from your model that corresponds to the ID of your Pendo profile. In the example below, we are mapping our model's `id` field to Pendo's `Visitor ID` field

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MXmiWh4Cgjj84lEkLL3%2F-MXmkqMaiP_BOEikgK18%2Fimage.png?alt=media\&token=81b6deba-1de6-433c-8c4b-435437242282)

Here is where you can find the ID in Pendo:

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MXmiWh4Cgjj84lEkLL3%2F-MXmlfNi4lp8wYIboqnS%2Fimage.png?alt=media\&token=2c65da3a-c6d8-4230-921f-545e3c7de228)

If users are not found in Pendo, the row will be automatically skipped.

### Mapping query columns to Pendo fields

Pendo has two types of fields:

* Agent fields: fields created by the API and the agent integrated on your website or app
* Custom fields: fields that are fillable in the UI and through the API

You can choose which specific fields you want to update on your profiles in Pendo. In the example below, we are mapping our model's `firstname` field to the field  `firstname` that is in Pendo.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MXmiWh4Cgjj84lEkLL3%2F-MXmmQtabc2_gOfdDnAe%2Fimage.png?alt=media\&token=b2d9c189-e993-4d94-8024-0c2de95207cd)

Custom fields can be created in Settings > Data Mappings in Pendo (<https://app.pendo.io/admin/mappings>).&#x20;

Agent fields cannot be created in the Pendo UI. If you want to write to a new field in Pendo that doesn't currently exist, you can pass in the desired field's name. The option to create that new field will appear, and if pressed, the field will be created during the next sync.&#x20;

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MXmiWh4Cgjj84lEkLL3%2F-MXmnqZyyp8lLVQq-JIj%2Fimage.png?alt=media\&token=09d0e1e3-f71c-4acf-b052-aa1d7f8c7f36)
