---
title: "Create store location"
method: POST
path: "/v1/store_locations"
tags: ["Store Locations"]
---

# Create store location

`POST /v1/store_locations`

Create a new store location (pickup point) with address, hours, and capacity settings.

## Request body

- CreateStoreLocationInputSerializer — Expected payload for creating a store location.
  - `name` string, required — Store business name at the origin. Limited to 80 characters.
  - `firstName` string, nullable — First name of the person at the store location. If unknown, pass 'Manager'. Limited to 80 characters.
  - `lastName` string, nullable — Last name of the person at the store location. If unknown, pass 'Manager'. Limited to 80 characters.
  - `phoneNumber` string, required — The phone number to contact at the store location: '+15555555555'
  - `email` string, nullable
  - `pickupInstructions` string, nullable — Any special instructions for store location. Limited to 280 characters. Nash Recommended Input: Order [insert order number] for [insert customer name] from [business name]
  - `address` string, nullable — The full address in one line for the store location for this package within the Job. Address format: [Number] [Street], [second line], [city], [state] [zip code]. All address fields are required except 'second line'. Second line should include Apt/Suite/Unit/# appended to the number of the unit. Can be null if using address_components.
  - `addressComponents` ParsedAddressInputSerializer — Parsed address input serializer for creating a job.
    - `number` string, nullable — The number of the address.
    - `secondaryNumber` string, nullable — The secondary number of the address.
    - `street` string, required — The street of the address. If your geocoding service does not split numbers from street names, you can pass the street name with the number in this field. Example: 1600 Pennsylvania Avenue NW.
    - `county` string, nullable — The county of the address.
    - `city` string, required — The city of the address.
    - `state` string, nullable — The state of the address.
    - `postalCode` string, nullable — The postal code of the address.
    - `country` string, required — The country of the address.
    - `latitude` number, nullable — The latitude of the address.
    - `longitude` number, nullable — The longitude of the address.
  - `externalId` string, nullable — Store location unique identifier from an external system.
  - `tags` string[], nullable — Free form tags specific to the location.
  - `operatingHours` object, nullable — [Integration Specific]: An object with keys that correspond to days of week (monday, tuesday, etc) and their corresponding operating hours / delivery windows. Example: {monday: {active: true, shifts: [[10:00, 17:00]]}, tuesday: {active: true, shifts: [[10:00, 17:00]]}, wednesday: {active: true, shifts: [[10:00, 17:00]]}, thursday: {active: true, shifts: [[10:00, 17:00]]}, friday: {active: true, shifts: [[10:00, 17:00]]}, saturday: {active: true, shifts: []}, sunday: {active: true, shifts: []}}
  - `prepTimeMinutes` integer, nullable — [Integration Specific]: the preparation time to apply for orders, if relying on Nash to compute the delivery windows. This only applies to specific integrations.
  - `zoneIds` string[], nullable — The zone ids to associate with the store location.
  - `zoneAssociations` object[], nullable — The zone associations to associate with the store location.

## Response `200`

OK

- StoreLocationResponse — Response for store location.
  - `externalId` string, nullable — Store location unique identifier from an external system.
  - `operatingHours` object, nullable — [Integration Specific]: An object with keys that correspond to days of week (monday, tuesday, etc) and their corresponding operating hours / delivery windows.
  - `prepTimeMinutes` integer, nullable — [Integration Specific]: the preparation time to apply for orders, if relying on Nash to compute the delivery windows. This only applies to specific integrations.
  - `blackoutDates` string[], nullable — The blackout dates of the store location.
  - `firstName` string, nullable — First name of the person at the store location. If unknown, pass 'Manager'. Limited to 80 characters.
  - `lastName` string, nullable — Last name of the person at the store location. If unknown, pass 'Manager'. Limited to 80 characters.
  - `email` string, nullable — The email of the person at the store location.
  - `pickupInstructions` string, nullable — The pickup instructions of the store location. Limited to 280 characters. Nash Recommended Input: Order [insert order number] for [insert customer name] from [business name]
  - `id` string, required — The ID of the store location.
  - `name` string, required — The name of the store location.
  - `phoneNumber` string, required — The phone number of the person at the store location.
  - `location` ParsedAddressInputSerializer, required — Parsed address input serializer for creating a job.
    - `number` string, nullable — The number of the address.
    - `secondaryNumber` string, nullable — The secondary number of the address.
    - `street` string, required — The street of the address. If your geocoding service does not split numbers from street names, you can pass the street name with the number in this field. Example: 1600 Pennsylvania Avenue NW.
    - `county` string, nullable — The county of the address.
    - `city` string, required — The city of the address.
    - `state` string, nullable — The state of the address.
    - `postalCode` string, nullable — The postal code of the address.
    - `country` string, required — The country of the address.
    - `latitude` number, nullable — The latitude of the address.
    - `longitude` number, nullable — The longitude of the address.
  - `zoneIds` string[], nullable, required — The zone ids of the store location.
  - `zoneAssociations` object[], nullable, required — The zone associations of the store location.
  - `tags` string[], nullable, required — The tags of the store location.
  - `integrationMetadata` object, nullable, required — The integration metadata of the store location.

## Other responses

- `422` — Unprocessable Content

---

[API](https://skmtc.net/usenash/apis/nash-api.md) · [All operations](https://skmtc.net/usenash/apis/nash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usenash/nash-api/versions/09a23a95889b/schema)