---
sourceDocument: Yokohama IT Asset Management
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/it-asset-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Asset Management

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Test the integration with the carrier API

# Test the integration with the carrier API {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Check the connection with the carrier API to handle any connection issues such as invalid credentials, incorrect tracking details, and issues with the integration script include.

## Before you begin

Role required: admin or domain_admin

## Procedure

1. Navigate to AllHardware Asset WorkspaceAsset operations.
2. From the Shipment list, select Carrier integration profiles.
3. Select the carrier integration profile that you want to test.
4. Select Test connection.

## Result

A message that indicates the success or failure of the connection is displayed.
**Related concepts**   

* [Creating an integration script include for third-party carrier applications](https://www.servicenow.com/docs/6opp1WgVssGWLmDT0i8Cfw "In order to integrate with a ServiceNow instance, a third-party carrier application must have a script include that extends the base class ITAMShipmentIntegration script on its ServiceNow instance to receive the shipment tracking number from the customer's ServiceNow instance and respond with the carrier-related details.")
* [Stale shipments](https://www.servicenow.com/docs/m97lmzeM8xwH6SMYAkVO0Q "Shipments that are delayed due to various reasons such as an incorrect tracking number, the loss of a shipment package during transit, and invalid connection details are considered stale shipments.")  
**Related tasks**   

* [Connect your ServiceNow instance with a shipping carrier application](https://www.servicenow.com/docs/~6XLVsmju4KfUrfmcbXHaA "Associate a shipping carrier with an integration profile to connect your ServiceNow instance to the carrier application.")
* [Remove a shipping carrier from an integration profile](https://www.servicenow.com/docs/wxDV0wEoE8b1YqW3WSbhAw "Remove a shipping carrier that you no longer want to associate with an integration profile.")
* [Create a carrier integration profile](https://www.servicenow.com/docs/zlsS7HuEQtJQ5e8JPbMjAw "Create a carrier integration profile for your carrier by specifying the API and connection details that are used to connect your ServiceNow instance to the third-party shipping carrier application.")
* [View the carrier integration profile details](https://www.servicenow.com/docs/LZqbHaH_zCt5m9RONX2x~Q "View the details of the carrier API used to connect your ServiceNow instance to the third-party shipping carrier application.")
* [Create a shipping carrier record](https://www.servicenow.com/docs/bpjMRDmrhdWqzsaigXDElA "Create a shipping carrier record used to associate the carrier with an integration profile.")
* [View hardware asset shipment details](https://www.servicenow.com/docs/T2HDKCLajTvB6mO_p2uLHA "View all hardware asset shipment details in a single place in the Hardware Asset Workspace.")
* [Track a hardware asset shipment](https://www.servicenow.com/docs/TvKJy1sCGKZp_iZLt0WuJw "Track the progress of your hardware asset shipment that isn't delivered and that has a carrier associated with an active integration profile.")

*[\>]: and then