--- title: "USPS Module" slug: "usps" description: "This document goes over the options available to web developers in Decisions, that come with the USPS Web Tool Kit APIs, and how to properly set up that kit. Utilizing this module lets a user's customers utilize functions provided by the USPS without leaving their website. Installing the module introduces the Steps, GetCityByZip, GetCitiesByZips, GetZipByCity, NormalizeAddres, and ISZipValidForCity, to the Decisions library. " updated: 2025-11-10T16:25:27Z published: 2025-11-10T16:25:27Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # USPS Module ## Overview | ## Module Details | | --- | | **Last Modified** | November 2025 | | **Installation Location** | [Github](https://github.com/Decisions-Modules) | | **Requires Restart?** | No | | **Step Location** | INTEGRATION > USPS | | **Settings Location** | System > Settings > USPS Settings | | **Prerequisites** | An active account with [USPS at Web Tools APIs](https://www.usps.com/business/web-tools-apis/); refer to their [Development Guide](https://www.usps.com/business/web-tools-apis/general-api-developer-guide.pdf) for more information. [Project Dependency](https://documentation.decisions.com/docs/project-dependencies) | The **USPS (United States Postal Service) Module** allows Users to integrate with the **USPS Web Tool Kit API,** allowing Developers access to the online services of USPS. This API provides easy access to shipping information and services for customers. By integrating these APIs into a website, Customers can utilize the functions provided by USPS without leaving the website. Once the APIs are integrated into a website, the**USPS Shipping API Server**communicates over HTTP using **XML**(Extensible Markup Language). The USPS Module provides Users with pre-built steps to get address information and validate the information. In addition to the USPS Module, the [Get Address Information](https://documentation.decisions.com/step-library/docs/get-address-information) step under **Integration > Google** can return similar results, including the latitude and longitude of an address. ## Considerations API Authentication USPS has updated its API Authentication strategy and now requires an account for API usage. Due to USPS's API deprecation in January 2026, new steps have been added to the USPS Module as of the v9.17 release. All steps added to the USPS Module before the v9.17 release are considered deprecated but will still work in the platform. Users must use the new steps once the change takes place. Users should also note that **n****ew****steps added to the platform from the v9.17 release are not a direct replacement for deprecated steps; Flow logic may need to be updated to account for this.**For more information about USPS's API change, please refer to**[Web Tools APIs | USPS](https://www.usps.com/business/web-tools-apis/?msockid=1eec7ce1518e68c03c7c6ab5509c695e).** --- ## Configuration In the Decisions platform, navigate **System > Settings**and click **USPS****Settings**. From the **Edit****USPS Settings**window, enter the **UserId**for the USPS Account. Click**SAVE.**![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-24_12h18_14.png) --- ## USPS Steps The Flow steps for the USPS Module are found in the **Toolbox**under **INTEGRATION > USPS**. Each step's input parameters can be configured on the **Properties**panel. | Step Name | Description | | --- | --- | | [Get Address](https://documentation.decisions.com/step-library/docs/get-address) | Allows Users to specify address data and retrieve a completed address from the USPS database. | | [Get City by Zipcode](https://documentation.decisions.com/step-library/docs/get-city-by-zipcode) | Allows Users to specify a tokenid and zipcode to retrieve the associated city and state. | | [Get Zipcode](https://documentation.decisions.com/step-library/docs/get-zipcode) | Allows Users to specify address data and retrieve a completed address | | [Get Cities By Zips **(Deprecated in v9.17)**](https://documentation.decisions.com/step-library/docs/get-cities-by-zips) | Allows Users to enter a list of zip codes. The step will return the city of each zip code entered. | | [Get City By Zip **(Deprecated in v9.17)**](https://documentation.decisions.com/step-library/docs/get-city-by-zip) | Allows Users to enter a zip code. The step will output the city of the zipcode entered. | | [Get Information By Zip **(Deprecated in v9.17)**](https://documentation.decisions.com/step-library/docs/get-information-by-zip) | Allows Users to enter a zip code and retrieve the associated city, zip, and state. | | [Get Zip By City **(Deprecated in v9.17)**](https://documentation.decisions.com/step-library/docs/get-zip-by-city) | Allows Users to enter an address field and city and retrieve the associated zip code. | | [Is Zip Valid by City **(Deprecated in v9.17)**](https://documentation.decisions.com/step-library/docs/is-zip-valid-for-city) | Evaluates whether the specified city and zip code are correct matches. | | [Normalize Address **(Deprecated in v9.17)**](https://documentation.decisions.com/step-library/docs/normalize-address) | Allows Users to enter an address and retrieve the full address from the USPS database, with a four-digit zip code extension. | For further information on Modules, visit the [Decisions Forum](https://community.decisions.com/categories/Modules).