Add a custom carrier

Use a Custom carrier account when you operate a private fleet or work with a carrier that's not in Carriyo's connector library. Compared to a connector-backed carrier account, the Custom wizard skips the carrier-specific credentials and product code steps; there's no integration to authenticate against. Status updates need to be wired separately via the API or applied manually in the dashboard.

The setup steps common to every carrier (sidebar navigation, general settings, save) are described once on Add a carrier account.

Before you start

• Decide on a carrier name (the carrier identifier, e.g., Own-Fleet, Local-Bikes) and an account name (your internal label for this fleet or service). The carrier name gets a Custom- prefix automatically.
• A plan for how status updates will reach Carriyo: via the API (programmatic) or manual dashboard updates. There is no automatic webhook for Custom carriers.

1. Open the carrier accounts page

In the Carriyo Dashboard, open Settings in the left sidebar.

Under Carrier Management, click Carrier Accounts to open the list of existing accounts.

Click the + add icon in the top-right corner to start a new account.

2. Pick Custom

In the carrier picker, search for Custom and click Select.

The Custom carrier is a generic connector: no carrier-specific fields, no carrier API to call.

3. Enter the basics

Carrier name. The carrier identifier. Custom carriers get a Custom- prefix automatically, so entering Own-Fleet registers as Custom-Own-Fleet. Keep it short and meaningful.

Account name. A label that's meaningful to your ops team. Keep it short and unique within the tenant.

Account country. The country the account operates from.

Click Next.

4. Finish the wizard

Click Go to Account to land on the new account's detail page.

5. Configure the account

The newly created account opens on its detail page.

The general settings (Active toggle, country, currency) are configured the same way for every carrier. See Add a carrier account → What's on the Account Setup tab for the full walkthrough.

A few of those settings behave differently for Custom carriers:

• Live Connector. No effect. There's no integration to switch between sandbox and live.
• Carrier Shipping Rates. No effect. There's no rate API to call. Use a costing profile to define rates instead.
• Default Label. Limited to Carriyo PDF and Carriyo ZPL. There's no carrier-generated label option because the carrier isn't integrated.

Merchant access

On multi-merchant tenants, restrict the account to specific merchants via the Permissions tab.

Click Save in the top-right corner.

Custom carrier-specific concepts

Carrier name vs account name

Two related but distinct fields. The carrier name identifies the carrier itself (Custom-Own-Fleet, Custom-Local-Bikes); multiple accounts can share the same carrier name. The account name identifies this specific account (Own-Fleet UAE, Own-Fleet UK). The dashboard groups carrier accounts by carrier name on the list page.

Create multiple Custom accounts under the same carrier name when you have several pickup countries or fleets that all operate under the same logical carrier.

Status updates

Custom carriers have no automatic webhook setup. Status updates reach Carriyo through one of:

• The Carriyo API. Your integration code pushes status events (shipped, out for delivery, delivered, etc.) as the carrier's events occur. The most common path for private fleets with their own tracking system.
• The Fulfillment App or Dashboard. Ops users can mark shipments through status transitions manually. Suitable for small fleets without a tracking integration.

The badge on each connector-backed carrier card on the Add a carrier account hub shows their webhook behavior for contrast.

Rates

Custom carriers don't expose a rate API, so Carriyo's Carrier Shipping Rates toggle has no effect for these accounts. Attach a costing profile to the account to drive shipment cost calculations. The costing profile can model a flat fee, a per-kg incremental rate, or any other structure your contract specifies.

Multiple Custom accounts

Create one Custom account per logical pickup point or service. Common patterns:

• One per pickup country (one account for UK pickups, one for AE pickups).
• One per fleet or vehicle category (van fleet vs bike couriers).
• One per service tier (same-day vs next-day on the same fleet).

Manage account assignments lets you wire costing, network, and capacity profiles to each Custom account independently, the same way you would for connector-backed carriers.