Yodel Guide

Yodel offers domestic and international shipping services for shipments originating in Great Britain.

This guide provides developers an overview of shipping services that Yodel offers and the service codes that you will use to create Yodel shipments.

Connect Your Account

ShipEngine API allows you to connect your Yodel accounts programmatically without logging in to the ShipEngine API dashboard. This capability is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing Yodel accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect Yodel using the ShipEngine API.

For instructions on connecting Yodel via the ShipEngine dashboard, go to our Yodel help article.

Yodel Account Information Model

Example Request

POST /v1/connections/carriers/yodel

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
POST /v1/connections/carriers/yodel HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "nickname": "Test Yodel Account",
  "user_id": "your_user_id_here",
  "account_id": "your_account_id_here",
  "password": "your_password_here"
}

Example Response

1
2
3
{
  "carrier-id": "se-1234567"
}

Yodel Service Details

All Yodal services have a 40-character maximum for the name field and a 30-character maximum for each address_line field (address lines 1-4).

Please note: Not all services listed are available to every Yodel account. We recommend you check with Yodel so you know which services are available to your account, or list carrier services.

Yodel Domestic Service Details

Yodel International Service Details

Return Services

Return services not supported for this carrier.

Shipping to Northern Ireland

Yodel does not support the B2B (business to business) movement type, as defined by the Windsor Framework. You should not use Yodel services for this type of shipment.

For all other shipments going from the UK to Northern Ireland, Yodel requires the following data:

Yodel additionally recommends including the proper HS codes for the declarations in the shipment.

Adding Shipment Insurance

Yodel supports adding shipment insurance.

Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

You are now ready to create shipments using Yodel via ShipEngine!