---
title: "Create Location"
method: POST
path: "/v2/company/{company_id}/locations"
tags: ["Locations"]
---

# Create Location

`POST /v2/company/{company_id}/locations`

## Path parameters

- `company_id` integer, required

## Headers

- `x-api-version` string — An API version
- `x-company-guid` string, uuid

## Request body

- object
  - `name` string, required — Location name
  - `country` string, required — Country two letter abbreviation
  - `formatted_address` string — Full address
  - `state` string, nullable — State or province
  - `city` string, nullable — City
  - `latitude` string — locations latitude coordinates
  - `longitude` string — locations longitude coordinates
  - `place_id` string — Google Places location Id
  - `timezone` string — Timezone. Valid zone info name
  - `holiday_pay` boolean — When true, holiday pay is enabled
  - `sun_hours_close` string — Sunday closing time
  - `mon_hours_close` string — Monday closing time
  - `tue_hours_close` string — Tuesday closing time
  - `wed_hours_close` string — Wednesday closing time
  - `thu_hours_close` string — Thursday closing time
  - `fri_hours_close` string — Friday closing time
  - `sat_hours_close` string — Saturday closing time
  - `sun_hours_open` string — Sunday opening time
  - `mon_hours_open` string, nullable — Monday opening time
  - `tue_hours_open` string, nullable — Tuesday opening time
  - `wed_hours_open` string, nullable — Wednesday opening time
  - `thu_hours_open` string, nullable — Thursday opening time
  - `fri_hours_open` string, nullable — Friday opening time
  - `sat_hours_open` string, nullable — Saturday opening time
  - `sun_is_closed` boolean, nullable — If true, location is closed on Sunday
  - `mon_is_closed` boolean, nullable — If true, location is closed on Monday
  - `tue_is_closed` boolean, nullable — If true, location is closed on Tuesday
  - `wed_is_closed` boolean, nullable — If true, location is closed on Wednesday
  - `thu_is_closed` boolean, nullable — If true, location is closed on Thursday
  - `fri_is_closed` boolean, nullable — If true, location is closed on Friday
  - `sat_is_closed` boolean, nullable — If true, location is closed on Saturday
  - `enable_shift_feedback` boolean — If true end of shift feedback requests are enabled
  - `shift_feedback` boolean — If true end of shift feedback requests are enabled
  - `coupon` string, nullable — Optional coupon to apply to this location's billing
  - `stripe_token_id` string — Optional stripe payment token. If this is not provided, the account's default payment information will be used.
  - `copy_from_id` integer, nullable — Optional existing location id whose department and role structure the new location should copy

## Response `201`

Created

- object
  - `object` 'location', required
  - `data` object, required
    - `id` integer, required — Location ID
    - `company_id` integer, required — Company ID
    - `name` string, required — Location name
    - `country` string, required — Country
    - `state` string, nullable, required — State or province
    - `city` string, nullable, required — City
    - `formatted_address` string, nullable, required — Full formatted address
    - `lat` number, nullable — Latitude
    - `lng` number, nullable — Longitude
    - `place_id` string, nullable, required — Internal use
    - `timezone` string, required — Timezone. Valid zone info name
    - `timezone_updated` boolean, nullable — Internal use
    - `hash` string, required — Internal use
    - `mapping_id` string, nullable — Internal use
    - `department_based_budget` boolean, nullable, required — When true, department based budgeting is enabled
    - `holiday_pay` boolean — When true, holiday pay is enabled
    - `auto_send_log_book_time` string, nullable — Time the log book is automatically send
    - `sun_hours_close` string, required — Sunday closing time
    - `mon_hours_close` string, required — Monday closing time
    - `tue_hours_close` string, required — Tuesday closing time
    - `wed_hours_close` string, required — Wednesday closing time
    - `thu_hours_close` string, required — Thursday closing time
    - `fri_hours_close` string, required — Friday closing time
    - `sat_hours_close` string, required — Saturday closing time
    - `sun_hours_open` string, nullable, required — Sunday opening time
    - `mon_hours_open` string, nullable, required — Monday opening time
    - `tue_hours_open` string, nullable, required — Tuesday opening time
    - `wed_hours_open` string, nullable, required — Wednesday opening time
    - `thu_hours_open` string, nullable, required — Thursday opening time
    - `fri_hours_open` string, nullable, required — Friday opening time
    - `sat_hours_open` string, nullable, required — Saturday opening time
    - `sun_is_closed` boolean, nullable, required — If true, location is closed on Sunday
    - `mon_is_closed` boolean, nullable, required — If true, location is closed on Monday
    - `tue_is_closed` boolean, nullable, required — If true, location is closed on Tuesday
    - `wed_is_closed` boolean, nullable, required — If true, location is closed on Wednesday
    - `thu_is_closed` boolean, nullable, required — If true, location is closed on Thursday
    - `fri_is_closed` boolean, nullable, required — If true, location is closed on Friday
    - `sat_is_closed` boolean, nullable, required — If true, location is closed on Saturday
    - `shift_feedback` boolean, required — If true end of shift feedback requests are enabled
    - `message` string, nullable, required — Message visible to all employees
    - `deleted` boolean — If true the location is deleted
    - `created` string, date-time, required
    - `modified` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Server Error

---

[API](https://skmtc.net/7shifts/apis/7shifts-api.md) · [All operations](https://skmtc.net/7shifts/apis/7shifts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/7shifts/7shifts-api/revisions/96a02ef888ab/schema)