Webhooks facilitate the transfer of data between two platforms based on a specific trigger. A Generate Label Webhook serves as a universal, carrier-agnostic connection point. It allows you to request shipping labels from carriers, third-party logistics providers, or custom shipping services that do not have native integrations within ShipHero. This connection is established via the ShipHero API, enabling a bridge to any third-party carrier's API or proprietary delivery system.
IMPORTANT: The use of a Generate Label Webhook must be approved by ShipHero before development begins; contact support@shiphero.com to request approval.
US based carrier aggregators and customer requests are not supported. Reach out to our support team to connect with our Carrier Strategist team to discuss optimizing your carrier portfolio.
Common Use Cases
This feature is designed to be compatible with non-US shipping providers. Common use cases include:
- Regional & Local Carriers: Connecting to niche or local couriers not listed in ShipHero.
- Third-Party Aggregators: Routing requests through custom middleware or 3rd party shipping brokers.
- Proprietary Fleets: Generating labels from your own in-house delivery infrastructure.
- International Services: Integrating with specialized international couriers via their specific API endpoints.
Things to Consider
- Approval required: The ShipHero carriers team must approve all new generate label webhook requests.
- Quoting limitations: Quoting for carrier methods created via webhooks is not supported. These methods will not be included or considered when using carrier rate shopping tools within the platform.
Required Information
To register a webhook on your account, provide ShipHero Support with the following details:
| Requirement | Description |
| Name of the Method | The specific name for this shipping service (e.g., "Local Courier X"). |
| Endpoint URL | The URL where ShipHero sends the label request (e.g., https://example.com/print-label). |
| Tracking URL | The base URL used to generate tracking links (e.g., https://tracking.com/?ID=). |
NOTE: When configuring this feature, set the Carrier to API and select the custom method name you provided. ShipHero uses this name as a unique identifier to ensure the carrier returns the correct label type.
Additional Notes for 3PLs
- 3PL Level: When enabled at the 3PL level, the webhook is available across all client accounts. This includes the ability to create Automation Rules using the specified carrier method.
- Child Account Level: If enabled at the Child Account level, you must navigate to that specific account to select the method on the Order Details page. This configuration is required if the Use Customer Shipping Accounts setting is enabled.
Frequently Asked Questions
| Question | Answer |
| Does this work for a specific carrier not listed in ShipHero? | Yes. This webhook is designed to integrate with carriers or third-party services that can receive an API request. As long as the provider has an endpoint to receive data and return a label, you can use this method to connect them. |
| Can I use Rate Shopping with webhook carriers? | No. Because webhook carriers do not provide real-time quotes to ShipHero, they cannot be compared against native carriers in the rate shopping tool. |
| Why isn't my webhook appearing on the Order Details page? | If the webhook was registered at the Child Account level, it will only be visible when you are logged into that specific Child Account or have that child account selected from the 3PL Customer Dropdown. Check your account hierarchy levels. |
| Can I automate carrier selection for these labels? | Yes. If the webhook is enabled at a brand or child account level, you can create Automation Rules and map store shipping methods to assign this specific carrier method to orders. |
PRO TIP: When testing your webhook, use a tool like Webhook.site or Postman to verify that ShipHero is sending the expected payload to your endpoint before finalizing your custom carrier code.