POST /merchants/{merchantId}/shippingLocations

Creates a shipping location for the merchant account identified in the path. A shipping location defines an address where orders can be shipped to.

To make this request, your API credential must have the following role:

Servers

Path parameters

Name Type Required Description
merchantId String Yes

The unique identifier of the merchant account.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
id String No

The unique identifier of the shipping location, for use as shippingLocationId when creating an order.

contact Object No

The contact details for the shipping location.

contact.email String No

The individual's email address.

contact.lastName String No

The individual's last name.

contact.phoneNumber String No

The individual's phone number, specified as 10-14 digits with an optional + prefix.

contact.firstName String No

The individual's first name.

contact.infix String No

The infix in the individual's name, if any.

name String No

The unique name of the shipping location.

address Object No

The address details of the shipping location.

address.companyName String No

The name of the company.

address.postalCode String No

The postal code.

address.streetAddress String No

The name of the street, and the house or building number.

address.stateOrProvince String No

The state or province as defined in ISO 3166-2. For example, ON for Ontario, Canada.

Applicable for the following countries:

  • Australia
  • Brazil
  • Canada
  • India
  • Mexico
  • New Zealand
  • United States
address.country String No

The two-letter country code, in ISO 3166-1 alpha-2 format.

address.city String No

The name of the city.

address.streetAddress2 String No

Additional address details, if any.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.