--- title: Simple Guide to Webhooks description: This article applies to Team and Legacy editions.  Webhooks enable Centercode to send data to third-party systems and optionally receive data in return as External Data. External Data fields allow you --- [Skip to content](https://help.centercode.com/en/centercode-guide-to-simple-webhooks#main-content) [![New\_Centercode\_Logo.png\]](https://help.centercode.com/hs-fs/hubfs/New_Centercode_Logo.png?height=35&name=New_Centercode_Logo.png)](https://centercode.com/) - [Help Center Home](https://help.centercode.com/) - [Starter & Delta Edition Help](https://learn.centercode.com/) Open main navigation Close main navigation - [Help Center Home](https://help.centercode.com/) - [Starter & Delta Edition Help](https://learn.centercode.com/) - [Report an Issue](https://centercode.com/issue) [Report an Issue](https://centercode.com/issue) How can we help? - There are no suggestions because the search field is empty. 1. [Help Center](https://help.centercode.com/en?hsLang=en) 2. [Integrations](https://help.centercode.com/en/integrations?hsLang=en) 3. [Guides](https://help.centercode.com/en/integrations?hsLang=en#guides) # Simple Guide to Webhooks This article applies to **Team** and **Legacy** editions.  Webhooks enable Centercode to send data to third-party systems and optionally receive data in return as External Data. External Data fields allow you to add data to Centercode from your third-party systems, storing it against Users, and Feedback Tickets. This external data can then be used anywhere via the Data Engine - as Dynamic Tags, in User and Feedback Management, Reporting, and even other integrations! *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/guide-to-integration-terms-and-status-codes?hsLang=en)*.* #### Common use-cases for Webhooks - Integrating Centercode with your issue tracking system (like Agile Central, TFS, or Salesforce) - Automatically creating shipping lists via Fedex or Shippo - Triggering app distribution to approved testers via TestFairy - Sending user or feedback data to Slack for new user registration or critical ticket escalation - Requesting data from an external system to be stored within Centercode - Store data from your external CRM (e.g.: Salesforce) - Log user activity from your app - Check user status against government blacklists or run a background check - Store Feedback ID data for tickets sent to your issue tracker from Centercode #### Prerequisite criteria - Enhanced Integrations enabled - Community-level API Key ([click here](https://help.centercode.com/en/api-key-management-overview?hsLang=en)) - Third-party system’s API Endpoint URL - Community or Project Manager access ![](https://help.centercode.com/hubfs/Knowledge%20Base%20Resources/Knowledge%20Base%20Import/5252358ee8385c719ff460a9f8a76446.png) #### Creating your Webhook within Centercode Webhooks are located within User or Feedback Macros and are conceptually similar to an email notification for an alias or distribution list. To be successful, you’ll need to understand the type of message you’re sending (GET, POST, etc.), the endpoint destination, and the contents of the message. **From the Project Homepage:** 1. Click **Management** in the upper navigation bar 2. Click **Users \> Project users** or **Project configuration \> Feedback types** and select the modify pencil of the desired Feedback Type 3. Click **User** or **Feedback Resources** 4. Select **Create a macro** 5. Provide a **Name**, **Description**, and identifying **Key** 6. Enable the **Trigger webhooks** checkbox *At this point, technical help may be necessary - please work with a developer (and/or Centercode)* 1. Select GET, POST, PUT, PATCH, or DELETE in the **Web** **Request** method dropdown 2. Enter the Webhook URL provided by your third-party system into the **Web** **Request** text field 3. Add **Headers**, if needed 4. Select the appropriate **Content type**: JSON or Form (most commonly JSON) 5. Add your JSON or Form body to the **JSON** **Body** text field 6. This Body typically carries substantial data to be used by your endpoint system 7. Add any appropriate Dynamic Tags to send contextual data (dynamic user or feedback data) 8. If you’re expecting to store data returned by your external system as part of this request, check the **Capture return values** checkbox and refer to the Notes section below. 9. Fill out any additional, optional settings 1. If you want your Webhook Macro to display on the left-hand menu while viewing feedback, [enable the "Show as project user action" option](https://centercode.gyazo.com/f976f2675571fb78657a69bb8e73d2e5) and select the Teams you wish to use your Webhook Macro. It will display to users who can modify feedback. You’ve just created your Webhook! #### Capturing Return Values via External Data **Capture Return Values** refers to External Data that’s being returned to Centercode from your third-party system when your Webhook is triggered. External Data allows you to add data to Centercode from your third-party systems. Doing so stores this data against Users, Feedback Tickets, or Projects which can then be leveraged as Dynamic Tags, in User and Feedback Management, Reporting, or even in other integrations. ![](https://help.centercode.com/hubfs/Knowledge%20Base%20Resources/Knowledge%20Base%20Import/ef2c0ac6bfe20fc24641065d95cf7455.png) To capture External Data on a Webhook, check the Capture Return Values field in the Webhook’s configuration.  Select a pre-existing **External Data Group** or create a new one by clicking on the empty field and typing a new data group name to 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** basically refers to numbers to be returned - **String** refers to textual data returned Enabling the **Favorite** (Star) option will display this data within User Summaries or on the admin view of Feedback Tickets. #### Notes - A Macro will allow you to create a single instruction that expands automatically into a set of instructions to perform a particular task - **Please note that when sending a Post request to your Centercode API endpoint, the JSON body must be JSON encoded.** - External data, and external data groups CANNOT be manually edited or removed once they have been created. Any external data attached to your users is permanent, and can only be overwritten. - [Centercode Basics](https://help.centercode.com/en/centercode-basics?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/centercode-basics?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/centercode-basics?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/centercode-basics?hsLang=en#faqs) - [Community Administration](https://help.centercode.com/en/community-administration?hsLang=en#main-content) - [Community Administration](https://help.centercode.com/en/community-administration?hsLang=en#community-administration) - [Overviews](https://help.centercode.com/en/community-administration?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/community-administration?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/community-administration?hsLang=en#faqs) - [Project Administration](https://help.centercode.com/en/project-administration?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/project-administration?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/project-administration?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/project-administration?hsLang=en#faqs) - [Features & Test Planning](https://help.centercode.com/en/features-test-planning?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/features-test-planning?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/features-test-planning?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/features-test-planning?hsLang=en#faqs) - [Resources & Surveys](https://help.centercode.com/en/resources-surveys?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/resources-surveys?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/resources-surveys?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/resources-surveys?hsLang=en#faqs) - [Recruiting](https://help.centercode.com/en/recruiting?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/recruiting?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/recruiting?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/recruiting?hsLang=en#faqs) - [Feedback](https://help.centercode.com/en/feedback?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/feedback?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/feedback?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/feedback?hsLang=en#faqs) - [Dashboards & Reporting](https://help.centercode.com/en/dashboards-reporting?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/dashboards-reporting?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/dashboards-reporting?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/dashboards-reporting?hsLang=en#faqs) - [Integrations](https://help.centercode.com/en/integrations?hsLang=en#main-content) - [Overviews](https://help.centercode.com/en/integrations?hsLang=en#overviews) - [Guides](https://help.centercode.com/en/integrations?hsLang=en#guides) - [FAQs](https://help.centercode.com/en/integrations?hsLang=en#faqs) - [What's New?](https://whatsnew.centercode.com/) - [System Status](https://status.centercode.com/) - [Starter & Delta Edition Help Center](https://learn.centercode.com/) - [Report an Issue](https://centercode.com/issue) [![Centercode logo](https://help.centercode.com/hubfs/images/logos/Centercode-Logo.svg "Centercode logo")](https://centercode.com) Copyright © 2025, Centercode