Add a carrier account
Carriers in Carriyo follow the same setup pattern: a short wizard collects basics and credentials, then the account opens to settings where you tune labels, permissions, and carrier-specific options. The carrier-specific bits (credential fields, services, label formats, webhook behavior) vary per carrier. Pick yours below.
Pick your carrier
Looking for a different carrier? Carriyo connects to 100+ shipping carriers, and we're rolling out dedicated walkthroughs for all of them. These are the ones published so far. If yours isn't listed yet, follow the wizard above: the steps are the same for every carrier, and your specific credential fields come from your carrier rep. For private fleets or carriers without a built-in connector, see Add a custom carrier instead.
100+ carriers in the picker
Carriyo ships with connectors for 100+ regional and global carriers. The + add button on the carrier accounts page opens a searchable picker. Type the carrier name to filter.
The pages above cover three of the major connectors end-to-end. For everything else, the wizard structure is the same; your carrier rep will tell you which credentials Carriyo needs.
The wizard, in 7 steps
Every carrier follows the same shape:
- Settings → Carrier Accounts → +
- Pick the carrier
- Walk the wizard (basics, then credentials, clicking Next)
- Go to Account on the finish screen
- Tune settings on the Account Setup tab
- (Multi-merchant tenants) Grant merchant access on the Permissions tab
- Save
The screenshots below show what each post-wizard step looks like.
What's on the Account Setup tab
Carrier Account is Active. Toggle in the header. Must be on for routing to consider this account. Defaults to on; toggling off pauses without deleting.
Live Connector. Sandbox by default. Flip to live after you've smoke-tested.
Account Country and Account Currency. Required; both affect rate calculations and settlement.
Auto Mark as Ready-to-Ship. Auto-advances booked shipments. Useful where booking is readiness. Avoid for carriers with scheduled daily collections; each shipment otherwise fires a redundant pickup request.
Carrier Shipping Rates. When on, calls the carrier's rate endpoint. When off, uses your costing profiles instead. Off for carriers without a usable rate API.
Default label
Picks the label format returned by default for shipments booked with this account.
Carriyo PDF/Carriyo ZPL. Universal, available for every carrier that supports the underlying data.Carrier PDF/Carrier ZPL. Labels generated by the carrier itself, where supported (DHL Express, Aramex, FedEx, etc.).Carrier QR Code. Available if the carrier supports QR-code-based labels; particularly relevant for reverse shipments (paperless customer returns).
Pick the format that matches your warehouse printers: A4 PDF for laser, ZPL for thermal, QR Code for paperless returns where supported. Carrier-specific label templates and sizes live in a dedicated section further down the account page.
Merchant access
Open the Permissions tab. Merchant Access controls which merchants can use this carrier account. Defaults to All Merchants (including any merchant added in future): every merchant in the tenant can use this account.
On multi-merchant tenants, switch to Select Merchants to restrict the account to specific merchants. This is the primary way to keep one merchant's carrier accounts separate from another's.
If your tenant has only one merchant, leave the default.
Real-time status updates
How shipment status (picked up, in transit, delivered) flows from the carrier back to Carriyo varies. Each carrier card above has a badge showing which path applies:
Carriyo registers the webhook automatically when the account is created. Nothing for you to do.
You share the Callback Settings block on the Account Setup tab with your carrier rep so they can register the webhook on their side.
Carrier doesn't push updates. Carriyo polls the carrier's tracking API on a schedule; updates take a little longer to appear.
Before going live
Smoke-test in sandbox before flipping Live Connector to on:
- Create a test shipment, assign this account.
- Confirm a label is generated.
- Confirm a tracking number returns.
- For webhook carriers, fire a test status callback and confirm it lands.
Common mistakes
- Live toggle on too early. Credentials were entered against the sandbox endpoint, first real shipment fails. Smoke-test first.
- Multiple accounts, no profile assignments. When you have several accounts for the same carrier (different services, regions), attach costing, capacity, and network profiles to disambiguate them at routing time. See Manage account assignments.
- Picking a carrier you don't have a contract with. The picker shows every supported connector. The wizard happily accepts credentials, but the first shipment fails at the carrier's side.