---
title: "Create an location at which one or more terminals will reside"
method: POST
path: "/in-person/locations"
tags: ["In-Person Locations"]
---

# Create an location at which one or more terminals will reside

`POST /in-person/locations`

Use this endpoint to setup a new location which will be used for housing one or more terminals. Note that once created a location's address & geo co-ordinates cannot be changed and instead a new location must be created

## Headers

- `Account` string

## Request body

- object — The request for for creating an in-person location
  - `name` string, required — Your name for the location. This can be used for display purposes.
  - `address` InPersonLocationAddressRequest, required
    - `lineOne` string, required — First line of the address
    - `lineTwo` string, nullable — Second line of the address
    - `city` string, required — The address city/town
    - `country` string, required — The two-character ISO country code
    - `postalCode` string, required — The postal code/zip of the address
    - `region` string — The state/county/province/region Required if the address is in the US/Canada and must be a 2-character ISO state/province code
  - `geoCoordinates` GeoCoordinatesRequest, nullable — The geographic coordinates of the location.
    - `latitude` number, double, required — The latitude of the location (-90 to 90)
    - `longitude` number, double, required — The longitude of the location (-180 to 180)
  - `metadata` object, nullable — Your own custom key-value data for this object. These will be sent with any associated events on your webhooks. You can have a maximum of 10 pieces of metadata. Keys must be between 1 and 30 characters in length. Values must be between 1 and 250 characters in length.

## Response `200`

Resource successfully created

- InPersonLocation
  - `id` string — The unique Id of the location
  - `name` string — Your name for the location. This can be used for display purposes.
  - `address` InPersonLocationAddress
    - `lineOne` string — First line of the address
    - `lineTwo` string, nullable — Second line of the address
    - `city` string — The address city/town
    - `country` string — The two-character ISO country code
    - `postalCode` string — The postal code/zip of the address
    - `region` string — The state/county/province/region Required if the address is in the US/Canada and must be a 2-character ISO state/province code
  - `geoCoordinates` GeoCoordinates, nullable
    - `latitude` number, double
    - `longitude` number, double
  - `metadata` object — Your own custom key-value data for this object. These will be sent with any associated events on your webhooks. You can have a maximum of 10 pieces of metadata. Keys must be between 1 and 30 characters in length. Values must be between 1 and 250 characters in length.
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the object was created
  - `lastUpdatedTimestamp` integer — The epoch timestamp (seconds) when the object was last updated

## Other responses

- `400` — One or more inputs are invalid
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/778890ee7e72/schema)