The Generate Label Webhook is a universal, carrier-agnostic connection point that lets you request shipping labels from carriers, third-party logistics providers, or custom shipping services without a native ShipHero integration. It connects via the ShipHero API to any third-party carrier 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 for non-US shipping providers. Common use cases include:
- Regional & Local Carriers: Niche or local couriers not listed in ShipHero.
- Third-Party Aggregators: Custom middleware or third-party shipping brokers.
- Proprietary Fleets: Your own in-house delivery infrastructure.
- International Services: Specialized international couriers via their own API endpoints.
Things to Consider
- Approval required: All new Generate Label Webhook requests must be approved by the ShipHero carriers team.
- Quoting limitations: Webhook carriers do not support quoting and will not appear in the rate shopping tool.
- Voiding labels: Labels can be voided in ShipHero, but this does not void them with your carrier. You must also manually void the label through the carrier's portal or by contacting them directly.
Required Information
To register a webhook, provide ShipHero Support with the following:
| Requirement | Description |
|---|---|
| Name of the Method | The 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=). |
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, including the ability to create Automation Rules using the specified carrier method.
- Child Account Level: If enabled at the Child Account level, navigate to that specific account to select the method on the Order Details page. This is required when the Use Customer Shipping Accounts setting is enabled.
Frequently Asked Questions
| Question | Answer |
|---|---|
| Does this work for a carrier not listed in ShipHero? | Yes. As long as the provider has an endpoint that can receive data and return a label, you can use this webhook to connect them. |
| Can I use Rate Shopping with webhook carriers? | No. Webhook carriers do not provide real-time quotes to ShipHero and cannot be compared in the rate shopping tool. |
| Why isn't my webhook appearing on the Order Details page? | If registered at the Child Account level, the webhook is only visible when you are logged into that specific child account or have it selected from the 3PL Customer Dropdown. |
| Can I automate carrier selection for these labels? | Yes. If enabled at a brand or child account level, you can create Automation Rules and map store shipping methods to assign this 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.