How do I choose the carrier, service level, and signature confirmation on an order?

Pass a shipping object when you create or update an order. You can specify a carrier (ups, usps, fedex), a service_level, a signature_confirmation (standard or adult), or any combination. Give a generic service level on its own — ground, 2_day, next_day — and Blend selects the most appropriate carrier to meet it.

{
  "patient": { "external_id": "clinic-pt-4471" },
  "shipping": {
    "carrier": "usps",
    "service_level": "usps_ground_advantage",
    "signature_confirmation": "adult"
  },
  "products": { "prescription": [{ "product_code": "HC-RAPA31", "quantity": 1 }] }
}

Shipping preferences need to be enabled for your account. Confirm with your Blend contact before building against them.

Service levels

Carrier	Service levels
USPS	`usps_ground_advantage`, `usps_priority`, `usps_priority_express`
FedEx	`fedex_ground`, `fedex_2_day`, `fedex_express_saver`, `fedex_standard_overnight`, `fedex_priority_overnight`, `fedex_first_overnight`
UPS	`ups_ground`, `ups_second_day_air`, `ups_3_day_select`, `ups_next_day_air`, `ups_next_day_air_saver`
Generic	`ground`, `2_day`, `next_day`

If you send both carrier and service_level, the service level’s prefix must match the carrier. carrier: "usps" with service_level: "fedex_ground" is rejected. Send the generic level alone if you don’t care which carrier is used.

GET /api/v1/orders/shipping_options returns the carriers and service levels currently available to your account — read it rather than hardcoding this table.

Signature confirmation

standard — anyone at the address may sign
adult — signature from someone 21 or over

Updating shipping later

curl -X PATCH https://api.byblend.com/api/v1/orders/ORD250312003548IAU4 \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{ "shipping": { "service_level": "next_day" } }'

Update semantics are worth reading twice:

Omitted fields are left unchanged.
Send "signature_confirmation": null to clear a previously set signature preference.
Sending carrier or service_level does not clear an existing signature preference.

Shipping stays editable later in the order’s life than line items do — a label hasn’t been purchased yet at picked or verified. Once an order is shipped or delivered, shipping is fixed and the order returns tracking information instead.

Bringing your own label

If you generate labels yourself, send custom_shipping instead of shipping.

Bringing your own shipping label is only available to pre-authorized accounts. Talk to your Blend contact before building against it.

All four fields are required: label_url (a printable 4x6), tracking_number, tracking_url, and carrier.

{
  "custom_shipping": {
    "label_url": "https://yourcompany.com/labels/abc.pdf",
    "tracking_number": "1Z999AA10123456784",
    "tracking_url": "https://ups.com/track?tracknum=1Z999AA10123456784",
    "carrier": "UPS"
  }
}

Shipping preferences on an individual order can also be changed in the Blend Dashboard while the order is still editable — a quicker path for a single customer-service request than an API call.

Get shipping options

Live carriers and service levels

Update an order

PATCH the shipping object

Create an order

shipping or custom_shipping

Get an order's details

Shipments and tracking

Guides

Getting started

Prescriptions

Patients

Orders

Prescribers

Products and catalog

Reporting and operations

How do I choose the carrier, service level, and signature confirmation on an order?

Service levels

Signature confirmation

Updating shipping later

Bringing your own label

Get shipping options

Update an order

Create an order

Get an order's details

​Service levels

​Signature confirmation

​Updating shipping later

​Bringing your own label

Get shipping options

Update an order

Create an order

Get an order's details

Service levels

Signature confirmation

Updating shipping later

Bringing your own label