Create Locations | BigCommerce Developer Center

Create new locations.

Limits

Limit of 50 concurrent requests.
Limit of 100 active locations.

Create new locations. **Limits** * Limit of 50 concurrent requests. * Limit of 100 active locations.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Store Locations	read-only	`store_locations_read_only`
Store Locations	modify	`store_locations`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see API Accounts and OAuth Scopes.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Store Locations | read-only | `store_locations_read_only` | | Store Locations | modify | `store_locations` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts). For more about BigCommerce OAuth scopes, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Request

This endpoint expects a list of objects.

codestringOptional

Location user-defined unique identifier.

labelstringOptional

Location label.

descriptionstringOptional

Description of location. This field can be returned by the GraphQL Storefront API so that additional details can be exposed to customers on the storefront (customer-facing).

managed_by_external_sourcebooleanOptionalDefaults to false

Indicates if the third-party system is the source of truth for inventory values. If set to true, manually editing inventory in BCʼs control panel will be disabled.

type_idenumOptionalDefaults to PHYSICAL

Describe type of given location.

Allowed values:

enabledbooleanOptionalDefaults to true

operating_hoursobjectOptional

Schedule with opening and closing hours for each day of the week.

time_zonestringOptional

Time zone of location. For a list of valid time zones, please view: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

addressobjectOptional

Address is required if the locationʼs type_id is PHYSICAL.

storefront_visibilitybooleanOptionalDefaults to true

special_hourslist of objectsOptional

Response

Locations have been successfully created.

transaction_idstring

Unique identifier of performed action.

Errors

422

Unprocessable Entity Error

1	curl -X POST https://api.bigcommerce.com/stores/store_hash/v3/inventory/locations \
2	-H "X-Auth-Token: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '[
5	{
6	"code": "BIGC-1",
7	"label": "Central store",
8	"description": "Central shop of the world",
9	"managed_by_external_source": false,
10	"type_id": "PHYSICAL",
11	"enabled": true,
12	"operating_hours": {
13	"sunday": {
14	"open": false,
15	"opening": "08:00",
16	"closing": "16:00"
17	},
18	"monday": {
19	"open": false,
20	"opening": "08:00",
21	"closing": "16:00"
22	},
23	"tuesday": {
24	"open": false,
25	"opening": "08:00",
26	"closing": "16:00"
27	},
28	"wednesday": {
29	"open": false,
30	"opening": "08:00",
31	"closing": "16:00"
32	},
33	"thursday": {
34	"open": false,
35	"opening": "08:00",
36	"closing": "16:00"
37	},
38	"friday": {
39	"open": false,
40	"opening": "08:00",
41	"closing": "16:00"
42	},
43	"saturday": {
44	"open": false,
45	"opening": "08:00",
46	"closing": "16:00"
47	}
48	},
49	"time_zone": "Etc/UTC",
50	"address": {
51	"address1": "5th Ave",
52	"city": "New York",
53	"state": "NY",
54	"zip": "10021",
55	"email": "test@example.com",
56	"geo_coordinates": {
57	"latitude": 40.774378,
58	"longitude": -73.9653178
59	},
60	"country_code": "US",
61	"address2": "string",
62	"phone": "800-555-0198"
63	},
64	"storefront_visibility": true,
65	"special_hours": [
66	{
67	"label": "Thanksgiving",
68	"date": "2022-09-29",
69	"open": true,
70	"opening": "09:00",
71	"closing": "09:00",
72	"all_day": false,
73	"annual": false
74	}
75	]
76	}
77	]'

1	{
2	"transaction_id": "string"
3	}