QUICKSTART
API Quick Start
Authentication
SignString
OAuth
Overview
Getting Started
Scope List
Rate Limit
Body Envelope
Request Errors
CHANGELOG
Changelog
REFERENCE
API Overview
v3
Rates
Get rates
get
Calculate rates
post
Get a rate
get
Labels
Get labels
get
Create a label
post
Get a label
get
Manifests
Get manifests
get
Create a manifest
post
Get a manifest
get
Couriers
Get all couriers
get
Cancel Labels
Get the cancelled labels
get
Cancel a label
post
Get a cancelled label
get
Pickups
Get pickups
get
Create a pickup
post
Get a pickup
get
Cancel Pickups
Get the cancelled pickups
get
Cancel a pickup
post
Get a cancelled pickup
get
Shipper Accounts
Get shipper accounts
get
Create a shipper account
post
Get a shipper account
get
Delete a shipper account
delete
Update a shipper account's information
put
Update a shipper account's credentials
patch
Update a shipper account's settings
patch
Specific Shipper Accounts
Create a FedEx shipper account
post
Update a FedEx shipper account
post
Address Validations (Beta)
Create an address validation
post
Locations
Get locations
get
MODEL
Envelope
Meta
v3
Error
v3
Primitive
Billing
v3
Customs
v3
Shipment
v3
Address
v3
Parcel
v3
Item
v3
Courier
v3
Reference
v3
Money
v3
PaymentMethodAccount
v3
Dimension
v3
Weight
v3
Volume
v3
Aes
v3
NoEei
v3
Resource
Rate
v3
RateRecord
v3
Label
v3
Manifest
v3
ShipperAccount
v3
CancelLabel
v3
AddressValidation (Beta)
v3
Location
v3
Pickup
v3
CancelPickup
v3
Carrier Guide
Supported Carriers
ENUM
Shipper Accounts Credentials
Service Types and Service Options List
All Service Options
Webhook
Webhook Overview
Webhook Specifications
Webhook Signature
Webhook Outgoing IPs
SDK
Java SDK
Node.js SDK
Open Source
phone
email-verifier
Support
Contact Support

Create a label

post
/labels

Create a label.

This array contains service_options object. Please refer to [all service options](../docs/enum/all-service-options.md) and [service options list](../docs/enum/service-types-and-service-options-lists.md) for details. This array contains reference data. Please refer to [reference](../model/premitive/reference.v3.json) object for label object details.
Content-Type
string
required

Content-Type

Default:
application/json
Example:
application/json

Create a label object.

billing
Billing

Billing object: the description of billing information

paid_by
string
required
Allowed values:
shipperthird_partyrecipient
method
PaymentMethodAccount

PaymentMethodAccount object: the description of account information

customs
Customs

Customs object: the description of customs information

purpose
string
required
Allowed values:
giftmerchandisepersonalsamplereturnrepairnon-merchandise
terms_of_trade
string
Allowed values:
datdduddpdapexwfcafobcipcifcptcfrdpu
eei

AES object: the description of EEI Type - aes

billing
Billing

Billing object: the description of billing information

importer_address
Address

Address object: the description of address information

broker_address
Address

Address object: the description of address information

passport
object

Passport Object

additional_charges
array[object]

This array contains additional_charges object. Additional charge to be added to the commercial invoice of this shipment. Only applies to FedEx, DHL Express, UPS currently.

<= 3 items
return_shipment
boolean

(set to false if not provided)

is_document
boolean

If the shipment is document type. (set to false if not provided)

service_type
string
paper_size
string
shipper_account
object
id
string
references
array[string]
shipment
Shipment

Shipment object: the description of shipment information

refer to [shipment](../model/resource/label.v3.json) object.
tax_total
Money

The money object is used to represent the currency amount.

ship_from
Address
required

Address object: the description of address information

ship_from_display
Address

Address object: An optional address object that lets you customize the ship from details shown on the shipping label.
This is only for visual display and won't change actual shipping routes or carrier operations.
Supported slug: purolator,canada-post

ship_to
Address
required

Address object: the description of address information

parcels
array[Parcel]
required

Parcels of shipment

return_to
Address

Address object: the description of address information

delivery_instructions
string

Instructions to aid in prompt delivery of the shipment.

invoice
Invoice or null

Invoice object: the description of invoice type, commercial invoice will be generated if field is present in the request body

date
string
required

Invoice date in YYYY-MM-DD

number
string

Invoice number

type
string
Allowed values:
commercialproforma
number_of_copies
integer
>= 1<= 4
signature_name
string

Signature name showing on invoice. Only applies to FedEx, DHL Express currently.

declaration_statement
string

Declaration statement showing on invoice. Only applies to FedEx, DHL Express currently.

service_options
array[object]

This array contains service_options object. Please refer to all service options and service types and service options list for details.

file_type
string
Allowed values:
pdfzpl
ship_date
string

Ship Date in YYYY-MM-DD, if not provided, will be today of the shipper account timezone

order_number
string

A user-defined order number used to identify an order.

order_id
string

Unique identification of the order.

custom_fields
object

Custom fields that accept an object with string field.Show all...

files
InputFiles

Files object: additional shipping documents to upload with label generation. Only applies to FedEx, DHL Express currently.

certificate_of_origin
object

Certificate of Origin

commercial_invoice
object

Commercial Invoice

customs_declaration
object

Customs Declaration

print_options
object
qr_code
object

Whether to return the qr_code when creating a label

  • Supported slug: arvato, canada-post, dpd-uk, evri, vesyl, usps, poste-italiane, pitney-bowes, dpd-nl
Auth
:
Parameters
:
Body
preparing...