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

# Create Location

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

## Request

- Base URL: `https://api.7shifts.com`
- URL: `https://api.7shifts.com/v2/company/{company_id}/locations`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.7shifts.com/oauth2/authorize`
    - Client credentials
    - Password
    - Token URL: `https://app.7shifts.com/oauth2/token`
  - API key in cookie `7session`

## 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.dev/7shifts/apis/7shifts-api.md) - [All operations](https://skmtc.dev/7shifts/apis/7shifts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/7shifts/apis/7shifts-api/revisions/40e0ef40dfcd?raw)