Add a Emirates Courier Express account
This guide walks through setting up a Emirates Courier Express account in the Carriyo Dashboard. It covers the required roles, the credentials to collect, and every field Emirates Courier Express expects.
At a glance
Before you start
- A Emirates Courier Express account in good standing, plus its API credentials. The required fields are listed in All Emirates Courier Express settings below.
- Decide the account country and the default service and label format this account uses.
Open the carrier accounts page
In the Carriyo Dashboard, open Settings in the left sidebar. Under Carrier Management, choose Carrier Accounts, then click the + add icon to start a new account.
Open settings
Go to Carrier Accounts
Add a new carrier account
Pick Emirates Courier Express
In the carrier picker, search for Emirates Courier Express and click Select. Carriyo creates a Emirates Courier Express account and opens the credential step.
Search for the carrier
Enter the basics
The first wizard page collects two fields:
- Account name
- A label that's meaningful to your team (e.g.
Emirates Courier Express United Arab Emirates). Keep it short and unique. - Account country
- The country this account ships from. Determines the routes and services available.
Fill in the account name and country.
- 1Account Name
- 2Account Country
Enter your Emirates Courier Express account details
Enter the required Emirates Courier Express account details, then click Next. Every field is documented in All Emirates Courier Express settings below, with examples and accepted values.
Enter emirates courier express account number.
- 1Emirates Courier Express Account Number
Fill in the Emirates Courier Express account details.
- 1Client Id
- 2Client Secret
Fill in the Emirates Courier Express account details.
- 1Service Type
- 2Shipment Purpose
- 3Payment Mode
- 4Terms Of Sale
Configure the account
The new account opens on its detail page. General settings work the same way for every carrier: the Active toggle, default label and service, and currency. See Add a carrier account for the full reference to these shared settings — default label, merchant access, going live, and common mistakes.
Go to the account page
View the account details
Set the default label format
Set up status callbacks
Emirates Courier Express sends shipment status by webhook, but it has to be registered on Emirates Courier Express's side. Copy the callback details from the account page and share them with your Emirates Courier Express contact. This is a one-time setup.
Share callback settings with your carrier
Merchant access
On multi-merchant tenants, restrict the account to specific merchants via the Permissions tab, then Save.
Add merchants to this carrier account
All Emirates Courier Express settings
Every field Emirates Courier Express exposes in the carrier account, grouped by section. Carriyo stores secrets encrypted and never shows them after saving.
Authentication
3 fieldsAccount identifiers and API credentials used to connect to the carrier.
| Field | Type | What to enter |
|---|---|---|
| Account NumberRequired | Text | Your Emirates Courier Express shipper account number, used for authentication and billing. Example: 123456 |
| Client IdRequired | Text | OAuth client ID supplied by Emirates Courier Express for API access. Example: your_client_id |
| Client SecretRequired | Text | OAuth client secret paired with the Client ID. Keep this confidential. Example: your_client_secret |
Product & Service
6 fieldsDefault Emirates Courier Express service, customs and billing settings applied to your shipments.
| Field | Type | What to enter |
|---|---|---|
| Service TypeRequired | Select | Emirates Courier Express service product code applied to each booking (EKX, EXE or EKF). Example: EKXEKXEXEEKF |
| Shipment PurposeRequired | Select | Reason for export as declared on customs paperwork (e.g. Commercial, Gift, Sample). Example: CommercialCommercialGiftSampleRepair and returnPersonal effectsPersonal use |
| Payment ModeRequired | Select | Who pays freight, duties and taxes: PX (all charges to shipper) or PD (duties/taxes to consignee). Example: PXPXPD |
| Download Emirates Courier Express Commercial InvoiceOptional | Select | Whether to download the Emirates Courier Express commercial invoice for international shipments. Example: YesYesNo |
| Terms Of SaleRequired | Select | Default Incoterm setting who pays duties and taxes on cross-border shipments. Example: Delivered Duty Paid (DDP) Free Carrier (FCA)Ex Works (EXW)Carriage/Insurance/Paid To (CIP)Carriage Paid To (CPT)Delivered at Place (DAP)Delivered Duty Unpaid (DDU) |
| Default Declaration StatementOptional | Text | Optional declaration text printed on the Emirates Express commercial invoice. |
Special Services Settings
1 fieldOptional value-added services applied to Emirates Courier Express shipments.
| Field | Type | What to enter |
|---|---|---|
| Special handling typesOptional | Multi | Optional special handling codes (e.g. signature required) added to every shipment. Example: SIG – Signature required SIG – Signature required |
Dangerous Goods Settings
5 fieldsDangerous goods classification and labelling details for regulated shipments.
| Field | Type | What to enter |
|---|---|---|
| UN IDOptional | Text | UN identification number for the dangerous substance (e.g. UN1234). Example: UN1234 |
| Class DivisionOptional | Text | Hazard class and division of the dangerous goods as per IATA/ADR regulations. Example: 3 |
| Packaging GroupOptional | Select | Packaging group indicating the degree of danger (I, II, III or None). Example: Medium danger (II) Higher Danger (I)Medium danger (II)Low danger (III)None |
| Excepted QuantityOptional | Select | Whether the shipment qualifies as an excepted quantity under dangerous goods regulations. Example: NoYesNo |
| Label instructions for the dangerous goodsOptional | Text | Optional handling and labelling instructions printed on the Emirates Express dangerous goods label. |
Reference Mappings
1 fieldMap Carriyo fields to the reference values the carrier expects.
| Field | Type | What to enter |
|---|---|---|
| Order ReferenceOptional | Select | Choose which Carriyo reference (order or shipment) is sent as the Emirates Express shipment ID. Example: Order Reference Order ReferenceShipment Reference |
Document Upload
1 fieldCustoms and shipping documents to attach to shipments.
| Field | Type | What to enter |
|---|---|---|
| Required | Text | Choose one of: Commercial InvoicePacking ListCertificate Of OriginOther |
Capability notes
Behavior that follows from Emirates Courier Express's capabilities. Read these before you go live.
shipped, in_transit, delivered…) arrive by webhook, but Emirates Courier Express has to register it on their side. Share the callback details from the account page with your Emirates Courier Express contact (see step 5) — a one-time setup.