---
title: Validating Shipping Address via Webhook
description: Validate shipping addresses with Centercode's Webhook integration, connecting with systems like Shippo, UPS, and more for accurate delivery.
---

[Skip to content](https://learn2.centercode.com/en/validating-shipping-address-via-webhook#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)

# Validating Shipping Address via Webhook

## Confirm addresses before shipping valuable test units or incentives via Shippo, UPS, USPS, FedEx, or another API-based system

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)*.*

[Webhooks](https://help.centercode.com/en/centercode-guide-to-simple-webhooks?hsLang=en) enable Centercode to send data to third-party systems and optionally receive External Data responses. External Data allows you to leverage that information by storing it against Users or Feedback Tickets. This can be used anywhere via the Centercode Data Engine - as Dynamic Tags, in User & Feedback Management, Reporting, and even other integrations! 

The principles included in this guide apply to triggering a Feedback or User Webhook Macro within Centercode to any API-capable endpoint and capturing return data. In this example, we’ll be sending Centercode user data to [Shippo](https://goshippo.com/) to validate shipping addresses. 

In this guide, you will:

1. Create an (or identify an existing) API Key in *Centercode*
2. Create a POST Webhook Request in *Centercode*
3. Configure External Data Fields to Capture Return Values in *Centercode*

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

1. Access to an existing API Key **or** Community Manager access to create a new one
2. Community or Project Manager access in the project of your choice (or your project template)
3. A valid Shippo authentication token

\-

### Preparing to send data to 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. While this integration doesn’t use an API key, your integration features won’t be visible unless one is available.

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

#### 2.  Creating a Webhook macro

Macros allow you to create a single instruction that includes a set of actions to complete a desired task. User Macros perform these actions on users relative to their accounts within Centercode. In this example, we’re creating a User Macro to send shipping data into your Shippo dashboard, then receive validation results.

**From the Community or Project Home:**

1. Click **Management \> Users \> Project users** in the upper navigation bar
2. Click **User resources**
3. Create a new Macro
4. Click **Trigger Webhooks**
5. Under Web Request, select POST and enter Shippo’s API Endpoint: [https://api.goshippo.com/addresses/](https://api.goshippo.com/addresses/)
6. Include the Shippo authorization token in the Header field (detailed below)
7. Select JSON from the **Content Type** dropdown
8. Add your **JSON Body** and Address Dynamic Tags (detailed below)
9. Select **Capture Return Values** (detailed below)
10. Create or select your **Data Group Label**
11. Create a **Label** for address validation results
12. In **Parameter**, type *validation\_results.is\_valid*
13. Select the Boolean data **Type**
14. Click the Add Field button
15. Under Additional Options, click **Show in User Management Actions**
16. Click Submit

You’ve just created your Webhook Macro to validate user shipping address!  
\-

#### Headers for authentication

Shippo’s API endpoint is static and authenticates through your header token. Headers allow you to define additional static values sent with each request. Not all API calls require headers to be defined, but Shippo does. Please add the following to your header:

Authorization: \<your Shippo token\>

**For example**  
*Authorization: ShippoToken shippo\_live\_ab123c2d123ef12  
\-*

#### The JSON Body

JSON is a computing language that’s used to transmit data to and from systems. This field is what is going to be sent from Centercode to your third-party system. Please feel free to use this example to send dynamic user shipping addresses. Centercode’s dynamic tags correspond to a shipping survey or User Profile. The minimum requirements are below:

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

#### Capturing external data

Note that you can find more information on the definitions of these fields and options in our [Integration Terms and Troubleshooting](https://help.centercode.com/en/understanding-integration-terms-and-troubleshooting-status-codes?hsLang=en) documentation. For this integration, the italicized text is used.

- Create a new **Data Group Label** or select a pre-existing group
- **Label** the data fields you're expected to receive and store   
  eg. *Address is Correct?*
- Use **Parameter** to identify the data received in the response from Shippo  
  eg. *validation\_results.is\_valid*
- For each incoming data point, set it's correct **Type** to properly classify it  
  eg. *Boolean*
- Mark the incoming data field as a **Favorite** to display it on the user’s Summary or feedback ticket

\-

### Using your address validation webhook

Once your Webhook Macro is configured, you may use it to send user data to your external system to capture return data. In this example, we’ll send tester shipping addresses to Shippo to capture validation results.

#### 3. Using your webhook

Like any User Macro within Centercode, you can trigger your Address Validation Macro manually (individually or in bulk), as a Notice ([Click here](https://help.centercode.com/en/what-are-notices-and-when-do-i-use-them?hsLang=en)), or on an automated schedule. 

**Bulk manual trigger**  
To trigger manually, start at the Community Homepage:

1. Click the upper left **Community Logo\>Community Administration\>Users**
2. Create a **Filter**, if desired
3. Under **Action**, select your Webhook Macro
4. Click **Perform Action**

You’ve just sent your data to your third-party system and captured return data!  
\-

#### 4. Review your external data results

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 user’s summary or feedback ticket.

**Creating an external data view**

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

**Viewing External Data in User Management**

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

### Troubleshooting your webhook

If you find that your Webhook failed or that data isn’t updated as expect, you’ll want to review the Webhook’s logs to troubleshoot any issues. 

**From User Management:**

1. Click User Resources
2. Hover over your Macro and click Macro Webhook Log
3. Hover over a username and click Macro Webhook Log

\-

Status codes are covered in this article:   
[Understanding Integration Terms & Troubleshooting](https://help.centercode.com/en/understanding-integration-terms-and-troubleshooting-status-codes?hsLang=en)

**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