Create a pickup

post
/pickups

Create a pickup. Applicable for FedEx, UPS, DHL Express, Purolator.

Content-Type
string
required

Content-Type

Default:
application/json
Example:
application/json

Create a pickup object.

pickup_date
string

Pickup Date should be provided in YYYY-MM-DD format. If it is not provided, it will default to today's date in the shipper account's timezone

pickup_start_time
string
required

Preferred start time for pickup in HH:mm:ss

pickup_end_time
string
required

Preferred end time for pickup in HH:mm:ss

pickup_from
Address
required

Address object: the description of address information

street1
string
required

address_line1 of address

country
string
required

Country in ISO 3166-1 alpha 3 code

contact_name
string
required

contact_name of address

phone
string

contact_phone of address

fax
string or null

fax_number of address

email
string or null

email of address

company_name
string or null

company_name of address

street2
string or null

address_line2 of address

street3
string or null

address_line3 of address

city
string or null

city of address

state
string or null

state of address

postal_code
string or null

postal_code of address

type
string or null

type of address

Allowed values:
residentialbusiness
tax_id
string or null

tax id

tax_id_type
string or null

tax id type. Only applies to DHL Express, DHL eCommerce US.

  • vat: Value-Added tax
  • gst: Goods and Service Tax
  • eori: European Union Registration and Identification
  • ioss: Import One Stop Shop
  • pan: Pan-Aarav
  • other: Other
Allowed values:
vatgsteoriiosspanother
identification_number
string or null

identification number

identification_type
string or null

identification type

  • mil: Military Number
  • nid: National Identity Card
  • pas: Passport
  • other: Other
Allowed values:
milnidpasother
eori_number
string or null

eori number

location
object or null
ship_to
Address

Address object: the description of address information

label_ids
array[string]

The id of labels that need to pickup. If label_ids are present, pickup_parcels should not be present

<= 2000 items
pickup_parcels
array[PickupParcel]

Parcel detail information which to be pickup. If label_ids are not present, pickup_parcels are required. When pickup_parcels are present, shipper_account is required

weight
Weight
required

Weight object: unit weight of the item

quantity
integer
required

The quantity of the packages. Minimum: 1

service_type
string

Service Type. Required for UPS and DHL Express

dimension
Dimension

Dimension object: the description of width/height/depth information

shipper_account
Reference

Shipper Account which register in Shipping. If pickup_parcels are present, shipper_account is required

id
string

id of referring object

pickup_location
string

Enum of shipments location which provided by the carrier. For more detailed information, please refer to the help article.

pickup_instructions
string

If you have any instructions for the pickup, they can be used as a note for some carriers

<= 255 characters
Auth
:
Parameters
:
Body
preparing...