POST
/
v1
/
locations
Create a location
curl --request POST \
  --url https://api.amberflow.io/v1/locations \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "customer_id": "cus_sAVSyzPS7qDWXELn",
  "latitude": 52.3938,
  "longitude": 4.8677,
  "metadata": {
    "address": "Nieuwe Hemweg 2, Amsterdam, Netherlands"
  }
}'
{
  "id": "991fced7-024c-4162-abbe-320fec9de64f",
  "created_at": "2024-09-23T12:00:00.000Z",
  "customer_id": "cus_sAVSyzPS7qDWXELn",
  "latitude": 52.3938,
  "longitude": 4.8677,
  "metadata": {
    "address": "Nieuwe Hemweg 2, Amsterdam, Netherlands"
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
customer_id
string
required
Examples:

"cus_sAVSyzPS7qDWXELn"

​
latitude
number
required
Examples:

52.3938

​
longitude
number
required
Examples:

4.8677

​
metadata
object | null

Metadata on the location for easier querying.

Examples:
{
  "address": "Nieuwe Hemweg 2, Amsterdam, Netherlands"
}

Response

Successful Response

​
id
string
required
Examples:

"991fced7-024c-4162-abbe-320fec9de64f"

​
created_at
string<date-time>
required
Examples:

"2024-09-23T12:00:00.000Z"

​
customer_id
string
required
Examples:

"cus_sAVSyzPS7qDWXELn"

​
latitude
number
required
Examples:

52.3938

​
longitude
number
required
Examples:

4.8677

​
metadata
object
required

Metadata on the location for easier querying.

Examples:
{
  "address": "Nieuwe Hemweg 2, Amsterdam, Netherlands"
}