Create location

Creates a location with all of its details, such as location number, name, address, operating hours, operation type, location coordinates, and so on.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-site-context

string

required

The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.

Example:

"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"

Body

application/json

Location details

attributes

object

Custom location attributes

Example:

{ "isReturns": true }

locationNum

integer

Unique number to identify the location

Example:

13

name

string

Name of the location

Example:

"CA"

isActive

boolean

true indicates location is active<br />false indicates location is inactive.

Example:

true

address

object

Location address details

Show child attributes

address.addressLine1

string

Address line 1

Example:

"2800 Ashcraft Court"

address.addressLine2

string

Address line 2

Example:

"Fairview road"

address.addressLine3

string

Address line 3

Example:

"N 9 1/2 street"

address.addressLine4

string

Address line 4

Example:

"Coronado school"

address.city

string

city

Example:

"Coronado"

address.state

string

State name the location belongs to

Example:

"California"

address.country

string

Country name of the location

Example:

"USA"

address.postalCode

string

Postal code

Example:

92118

address.type

string

Address type

Example:

"2800 Ashcraft Court"

address.contact

object[]

Contact list

Location contact details

Show child attributes

address.contact.type

string

Contact type

Example:

"Residence"

address.contact.email

string

Email address of the location

Example:

"[e-mail]"

address.contact.phone

object[]

Phone list

Phone details

Show child attributes

address.contact.phone.number

string

Example:

"555-555-5555"

address.contact.phone.type

string

Example:

"mobile"

address.contact.name

object

Name object contains full name of the individual to contact, who reside in the location

Show child attributes

address.contact.name.first

string

First name

Example:

"John"

address.contact.name.middle

string

Middle name

Example:

"Mark"

address.contact.name.last

string

Last name

Example:

"Doe"

type

string

Type of inventory location

Example:

"Warehouse"

operatingHours

object[]

Operating hours of the location

Operating hours of the location

Show child attributes

operatingHours.day

string

Day of the week

Example:

"Monday"

operatingHours.hours

object[]

Show child attributes

operatingHours.hours.open

string

Location opening time

Example:

"10:00"

operatingHours.hours.close

string

Location closing time

Example:

"16:00"

operatingHours.hours.type

enum<string>

operating type

Available options:

OPEN,

PICK_UP

coordinates

object

coordinate details of the location in Geo Json format

Show child attributes

coordinates.type

string

Coordinate type

Example:

"Point"

coordinates.coordinates

number[]

Coordinate list, x and y coordinates in degree

services

object

JSON attributes on which locations are allowed to filter

Example:

{ "isCurbsidePickUp": false }

Response

200

application/json

Success

This object contains location details

attributes

object

Location attribute object

Example:

{ "isReturns": true }

id

string

Unique location identifier

Example:

"622fae9a065d9e62a4029f79"

locationNum

integer

Unique number to identify the location

Example:

13

name

string

Location name

Example:

"CA"

isActive

boolean

true indicates location is active<br />false indicates location is inactive.

Example:

true

address

object

Location address details

Show child attributes

address.addressLine1

string

Address line 1

Example:

"2800 Ashcraft Court"

address.addressLine2

string

Address line 2

Example:

"Fairview road"

address.addressLine3

string

Address line 3

Example:

"N 9 1/2 street"

address.addressLine4

string

Address line 4

Example:

"Coronado school"

address.city

string

city

Example:

"Coronado"

address.state

string

State name the location belongs to

Example:

"California"

address.country

string

Country name of the location

Example:

"USA"

address.postalCode

string

Postal code

Example:

92118

address.type

string

Address type

Example:

"2800 Ashcraft Court"

address.contact

object[]

Contact list

Location contact details

Show child attributes

address.contact.type

string

Contact type

Example:

"Residence"

address.contact.email

string

Email address of the location

Example:

"[e-mail]"

address.contact.phone

object[]

Phone list

Phone details

Show child attributes

address.contact.phone.number

string

Example:

"555-555-5555"

address.contact.phone.type

string

Example:

"mobile"

address.contact.name

object

Name object contains full name of the individual to contact, who reside in the location

Show child attributes

address.contact.name.first

string

First name

Example:

"John"

address.contact.name.middle

string

Middle name

Example:

"Mark"

address.contact.name.last

string

Last name

Example:

"Doe"

type

string

Location type

Example:

"warehouse"

createdAt

string

Date on which the location is created

updatedAt

string

Date on which the location is updated

operatingHours

object[]

Operating hours of the location

Operating hours of the location

Show child attributes

operatingHours.day

string

Day of the week

Example:

"Monday"

operatingHours.hours

object[]

Show child attributes

operatingHours.hours.open

string

Location opening time

Example:

"10:00"

operatingHours.hours.close

string

Location closing time

Example:

"16:00"

operatingHours.hours.type

enum<string>

operating type

Available options:

OPEN,

PICK_UP

coordinates

object

coordinate details of the location in Geo Json format

Show child attributes

coordinates.type

string

Coordinate type

Example:

"Point"

coordinates.coordinates

number[]

Coordinate list, x and y coordinates in degree

services

object

JSON attributes on which locations are allowed to filter

Example:

{ "isCurbsidePickUp": false }