---
title: "Create predefined location"
method: POST
path: "/configuration/predefined-locations"
tags: ["predefined-locations"]
---

# Create predefined location

`POST /configuration/predefined-locations`

Creates new predefined location

## Request body

- PredefinedLocationRequest
  - `city` string, required — Not blank. No leading and trailing spaces allowed.
  - `countryCode` string, required — ISO-3166-1 alpha-2 country code
  - `region` string
  - `regionAbbr` string — Not blank. No leading and trailing spaces allowed. Region abbreviation, if applicable. E.g. Utah -> UT.
  - `address` string — Not blank. No leading and trailing spaces allowed.
  - `postalCode` string — Not blank. No leading and trailing spaces allowed.
  - `lat` number — Decimal latitude value
  - `lng` number — Decimal longitude value
  - `title` string — User managed Title. If present, value must not be blank and must be unique within the company (case insensitive).
  - `identifier` string — Only alphanumerical characters, dashes, hashes and underscores are allowed. User managed Identifier. If present, value must not be blank and must be unique within the company (case sensitive).

## Response `200`

Predefined location successfully created

- PredefinedLocation
  - `id` string, uuid
  - `country` string
  - `region` string
  - `regionAbbr` string
  - `countryCode` string
  - `city` string
  - `address` string
  - `postalCode` string
  - `title` string
  - `identifier` string
  - `lat` number
  - `lng` number

## Other responses

- `400` — Invalid request
- `422` — Cannot create predefined location for the following reason: - PREDEFINED_LOCATIONS_COUNT_LIMIT_EXCEEDED - The maximum count of predefined locations has been reached for the company - TITLE_ALREADY_EXISTS - The title is already used for another predefined location - IDENTIFIER_ALREADY_EXISTS - The identifier is already used for another predefined location - PREDEFINED_LOCATIONS_COUNT_LIMIT_EXCEEDED - The maximum count of predefined locations reached

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)