Skip to main content

carrierCreate

Create a new shipping carrier in the system.

Establishes a new carrier with service details, coverage areas, pricing information, and integration settings. The carrier will be available for shipping calculations and logistics operations immediately after creation. Validates warehouse IDs against the warehouse service to ensure coverage areas exist.

Possible errors:

  • CARRIER_CREATE_ERROR: Failed to create the carrier due to data source issues or warehouse validation failure
  • CARRIER_ALREADY_EXISTS_ERROR: Carrier with the same name already exists within the organization
  • FORBIDDEN: Insufficient permissions to create carriers

AUTH: Role=[logistics.OWNER]

carrierCreate(
  input: CarrierCreateInput!
): Carrier!

Arguments​

carrierCreate.input ● CarrierCreateInput! non-null input​

Carrier creation data including service details and configuration.

Contains all required and optional carrier information including name (maximum 64 characters), service type, localized descriptions, shipping cost, tracking URL template (HTTPS only), logo URL, and warehouse coverage areas. All warehouse IDs are validated against the warehouse service.

Type​

Carrier object​

Shipping carrier configuration for logistics and delivery operations.

Represents a shipping company or service provider including service details, coverage areas, pricing information, and integration settings. Used for shipping calculations, order fulfillment, and logistics management.