---
title: How to store data from other systems (e.g. Salesforce, mobile apps, etc.).
description: Learn how to append custom data to Centercode users from external systems like Salesforce using External Listeners.
---

[Skip to content](https://learn2.centercode.com/en/appending-custom-data-to-centercode-users-via-external-listeners#main-content)

English

Show submenu for translations

[Report an Issue](https://learn2.centercode.com/en/kb-tickets/new?hsLang=en) [Customer portal](https://help.centercode.com/admin-portal?hsLang=en)

![New\_Centercode\_Logo.png\]](https://learn2.centercode.com/hs-fs/hubfs/New_Centercode_Logo.png?height=35&name=New_Centercode_Logo.png)

- [Centercode Blog](https://www.centercode.com/blog)

Open main navigation

Close main navigation

- [Centercode Blog](https://www.centercode.com/blog)
- English
  
  Show submenu for translations
- [Report an Issue](https://learn2.centercode.com/en/kb-tickets/new)
- [Customer portal](https://help.centercode.com/admin-portal)
- Starter & Delta Edition Help

 Starter & Delta Edition Help

 How can we help?

- There are no suggestions because the search field is empty.

1. [Legacy Help Center](https://learn2.centercode.com/en?hsLang=en)
2. [Enhanced Integrations & APIs](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en)
3. [Centercode Guides to Endpoint Specific Systems](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#centercode-guides-to-endpoint-specific-systems)

# How to store data from other systems (e.g. Salesforce, mobile apps, etc.).

## Append custom data to users in Centercode via the External Listeners tool

This article applies to **Team** and **Legacy** editions.

*Note that while Centercode’s integration features are intended to be approachable by a Customer Validation Professional, you might need to enlist help from an internal technical resource and refer to our* [*vocabulary and troubleshooting documentation*](https://help.centercode.com/en/understanding-integration-terms-and-troubleshooting-status-codes?hsLang=en)*.*

Through Enhanced Integrations, Centercode offers integration functionality to allow your own application to append custom data **to users** within Centercode. The Centercode platform allows you to generate an API endpoint to accept incoming Webhooks containing custom JSON data to further extend Centercode’s Data Engine. 

The principles included in this guide apply to **any API-capable endpoint that can send data to a Centercode API endpoint in JSON format**. In this example, we’ll be capturing and appending custom data sourced from a third-party app to existing Centercode users using External Listeners.

![](https://t.gyazo.com/teams/centercode/3e56cbc0b605a9118de305915febbd91.png)

In this guide, you will:

1. Create (or identify) an API Key in ***Centercode***
2. Create a User External Listener in ***Centercode***
3. Send data to the External Listener Endpoint ***from your application***
4. Review External Data received in ***Centercode***

In order to configure both sides of this integration, you will need:

- Access to an existing API Key **or** Community Manager access to create a new one
- Project Manager access in the project of your choice (or your project template)

#### Preparing Centercode to Listen for Your External System

#### 1.   Creating an API Key

From the Centercode side, the first step in any API integration is to ensure that you have an API Key available within your Centercode Community. API Keys are used to track and control how API endpoints are accessed and can be leveraged by multiple simultaneous API integrations. If one is already created and available for use, you may continue past this step.

If necessary, create a Community API Key by following the steps [outlined here](https://help.centercode.com/en/creating-your-community-level-api-key?hsLang=en).

#### 2.   Creating an External Listener

An External Listener is effectively an API endpoint created within your Centercode implementation that your third party system reaches out to. This provides a path for a system to interact with your Centercode implementation for a predetermined purpose. In this case, to append data to existing Centercode users. 

**From your Project Homepage:**

1. Click **Management \> Users \> Project users**
2. Click **User automation**
3. Click **Create an external listener**
4. Create an (internally-facing) **name**
5. Add a simple **key** to help identify this External Listener (ex: “appdata”)
6. Add a **Filter**, if desired
7. Under Listener Type dropdown, **select External data**
8. Name your **Data group label** or select one existing
9. **Copy / Save** the provided API Endpoint URL (needed in Section 3 below)
10. Click Submit

![](https://t.gyazo.com/teams/centercode/5bcc2d49554e00e4157398442b03be77.png)

![](https://t.gyazo.com/teams/centercode/5aa1b954b63507443ee7a2cb7ce956d3.png)

1. **Data group label** is your **Dataset**
2. **External data fields** are your **Dataset** **items**
3. **Label** is your **internal label**
4. **Paramaters** are the unique identifiers that link to data
5. **IMPORTANT: Replace VALUE with user email or username**
6. Send JSON data to the API Endpoint

![](https://learn2.centercode.com/hubfs/Knowledge%20Base%20Import/downloads.intercomcdn.comio855320262e697a4ebc381718d966c138FZRYFv0Tm7ZrEumSfv1u9t-YelJrD4gmkUSuFvM0TBQn67z132YhOd9ESGvVpBfDVJZNgq-twmnaaskrdnB1s.png)

#### Listener Notes

Data Group Label refers to how you’ll identify and categorize data captured from your external system. These groups are functionally identical to User Account, Participation, or Surveys data groups. External Data Fields are shown in Reporting and User or Feedback Management as the Label, and are mapped from your external system’s webhook request via the Parameter field.

Selecting the correct data Type allows you to report on and visualize the stored data as the correct type.

- Boolean refers to values returned as true and false
- Date and Time refers to dates and times returned
- Integer refers to numbers to be returned
- String refers to textual data returned

External Data Listeners follow the same “key value pair” design but let you pick the Label. The Parameter must still match the parameter sent by your third-party system.

#### 3.    Sending Data to Your External Listener

Now that you’ve created an API endpoint URL to capture data, you’re able to use your third-party system to send data to be captured by Centercode. Have the URL from Step 9 above ready. **Please note that when sending a Post request to your Centercode API endpoint, the JSON body must be JSON encoded.**

**![](https://t.gyazo.com/teams/centercode/33543e65d8704f350e1171289a61195f.png)**

Here’s an example of Postman sending data to Centercode’s External Listener. Notice that the data sent to the API Endpoint generated and data is mapped to Paramater’s set within Centercode. 

[![](https://learn2.centercode.com/hubfs/Knowledge%20Base%20Import/downloads.intercomcdn.comio85532033d8940427842d56d5f3967923cc73e5635b2e7a26b2170919440ba1e3.png)](https://centercode.gyazo.com/a29ae8b531aa167eda63a44222747d5a)

#### 4.   Reviewing your External Data

The External Data returned from your third-party system extends the reach of your Centercode Data Engine. These results can be leveraged in Reporting, User or Feedback Management, and the user’s summary or feedback ticket. 

**Creating your Filter**

To review your results, you can simply create a custom Filter and View within User Management, or build a report. Building a Filter hones the scope of data you want to see. You’re setting criteria you want your data to match. If you'd like to see all results, No Filter may work for you.

1. Click **Users** or your **Feedback Type** in the **Management** section of the navigation bar
2. Click the **+** button to the right of the Filter drop-down
3. Select the desired **Data set**, **Item**, **Default qualifier**, and optionally a **Default value**
4. Click **Add to filter**
5. Repeat steps 3 and 4 until all desired Filter criteria have been added
6. Click the **Create filter** at the bottom

**Creating your View**

Once your Filter is complete, it’s time to build a View. Typically, the View is the information you’d like to see regarding your filtered results. In this example, we’re selecting your External Data.

![](https://t.gyazo.com/teams/centercode/72173782003358a7a27249d45b2a94c0.png)

1. Click the + button to the right of the **View** drop-down
2. Select the **Data set** and highlight the item in the left text field
3. Double-click the item to move it to your View.
4. Repeat steps 2 and 3 until all desired View items have been added to the View
5. Click **Create view and execute** to see your results

**Creating a Report**

All Report creation is done on a single page and shows your data in real-time. Reporting can analyze your data, report distributions, and generate exports. 

1. Click **Management \> Custom reports** (For Community Report, click Community Tools first)
2. Click **Create a report**
3. **Select datasource: Single elements** contain user or project information.
4. **Select your data** - This is where you’re selecting your External Data
5. **Add filter**, if desired
6. Pick a Style - Visual presentation of your report element. Available styles determined by data items selected.
7. Name report element and choose destination.
8. Click **Submit t**o proceed to the next page.
9. Name your Element
10. Click **Submit** to save and generate your Report.

Once you’ve created your report(s), your preferred method of consumption and dissemination will lead you down any of three paths. First, you can view your report directly within the Reporting interface. Second, exporting the report to PDF, CSV, or XLSX allow you to take the data off-line or into a more manipulable format. Finally, you may prefer to send that report and all its contents to your stakeholders for review through a regularly scheduled distribution. 

**Exporting Report Data**

Your data doesn’t have to live solely within your Centercode implementation. Exporting your saved reports allows you to take your data off-line which you may put into a format able to be manipulated. Exporting complete reports or individual elements are available in a number of valuable formats: PDF, CSV, or Excel’s XLSX. These allow you to consume the information within however you see fit. 

**Distributing Reports**

Distributing a Report sends you a complete package of formats that includes both reporting formats (PDF & XLSX), as well as an HTML email. You can choose to send a one-off distribution to the email address(es) of your choice or set up an automatic, scheduled distribution to entire Project Teams or a list of individuals.

 

**Please note that when sending a Post request to your Centercode API endpoint, the JSON body must be JSON encoded.**

- [Customer Training & Centercode Basics](https://learn2.centercode.com/en/customer-training-centercode-basics?hsLang=en#main-content)

    - [Customer Video Training](https://learn2.centercode.com/en/customer-training-centercode-basics?hsLang=en#customer-video-training)
    - [Centercode FAQs](https://learn2.centercode.com/en/customer-training-centercode-basics?hsLang=en#centercode-faqs)
    - [Centercode Basics](https://learn2.centercode.com/en/customer-training-centercode-basics?hsLang=en#centercode-basics)
- [Community Administration](https://learn2.centercode.com/en/community-administration?hsLang=en#main-content)

    - [Initial Configuration](https://learn2.centercode.com/en/community-administration?hsLang=en#initial-configuration)
    - [Community Administration](https://learn2.centercode.com/en/community-administration?hsLang=en#community-administration)
- [Project Setup & Administration](https://learn2.centercode.com/en/project-setup-administration?hsLang=en#main-content)

    - [Project Creation](https://learn2.centercode.com/en/project-setup-administration?hsLang=en#project-creation)
    - [Recruiting](https://learn2.centercode.com/en/project-setup-administration?hsLang=en#recruiting)
    - [Project Administration](https://learn2.centercode.com/en/project-setup-administration?hsLang=en#project-administration)
    - [Macros and Automation](https://learn2.centercode.com/en/project-setup-administration?hsLang=en#macros-and-automation)
- [User Management](https://learn2.centercode.com/en/user-management?hsLang=en#main-content)

    - [Surveys](https://learn2.centercode.com/en/user-management?hsLang=en#surveys)
    - [Content & Resources](https://learn2.centercode.com/en/user-management?hsLang=en#content-resources)
    - [Tester & User Management](https://learn2.centercode.com/en/user-management?hsLang=en#tester-user-management)
- [Feedback Management](https://learn2.centercode.com/en/feedback-management?hsLang=en#main-content)

    - [Feedback Collection](https://learn2.centercode.com/en/feedback-management?hsLang=en#feedback-collection)
    - [Feedback Triage & Moderation](https://learn2.centercode.com/en/feedback-management?hsLang=en#feedback-triage-moderation)
- [Reporting](https://learn2.centercode.com/en/reporting?hsLang=en#main-content)

    - [Delta Dashboards](https://learn2.centercode.com/en/reporting?hsLang=en#delta-dashboards)
    - [Custom Reports](https://learn2.centercode.com/en/reporting?hsLang=en#custom-reports)
- [Enhanced Integrations & APIs](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#main-content)

    - [Integration Center Endpoints](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#integration-center-endpoints)
    - [Single Sign-On Integrations](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#single-sign-on-integrations)
    - [Centercode Guides to Simple API Integrations](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#centercode-guides-to-simple-api-integrations)
    - [Centercode Guides to Endpoint Specific Systems](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#centercode-guides-to-endpoint-specific-systems)
    - [Enhanced Integrations Troubleshooting](https://learn2.centercode.com/en/enhanced-integrations-apis?hsLang=en#enhanced-integrations-troubleshooting)
- [Troubleshooting & Miscellaneous](https://learn2.centercode.com/en/troubleshooting-miscellaneous?hsLang=en)
- [Announcements and Releases](https://learn2.centercode.com/en/announcements-and-releases?hsLang=en#main-content)

    - [C17 - The Delta Release](https://learn2.centercode.com/en/announcements-and-releases?hsLang=en#c17-the-delta-release)
    - [Centercode's GoEarly Program](https://learn2.centercode.com/en/announcements-and-releases?hsLang=en#centercodes-goearly-program)
    - [Update Archive](https://learn2.centercode.com/en/announcements-and-releases?hsLang=en#update-archive)

- [Centercode Blog](https://www.centercode.com/blog)

[![Chill listening crop-3](https://learn2.centercode.com/hs-fs/hubfs/Centercode_Logo_Icon_M.png?width=48&height=48&name=Centercode_Logo_Icon_M.png "Chill listening crop-3")](https://help.centercode.com?hsLang=en)

Centercode Help Center

Copyright © 2026, Centercode