---
title: "Create Custom POI"
method: POST
path: "/v1/poi/custom-poi"
tags: ["Manage POIs"]
---

# Create Custom POI

`POST /v1/poi/custom-poi`

The create <<glossary:Custom POI>> endpoint can be used to generate custom POIs by specifying the unique polygons to               analyze.<br/> The <<glossary:Custom POI>> can be generated by either specifying the combination of centroid (lng, lat) and mile radius to draw the POI's area, or by using GEOJson which includes a list of all polygon GEO points (lng, lat).<br/> This endpoint runs duplication checks on each call in order to ensure that the same <<glossary:Custom POI>> is not created more than once. If a <<glossary:Custom POI>> is already created the return code will display a wrong request (http-code=400) specifying the previously created API ID.</br> Please be aware that creating custom POIs might take longer than 30 seconds, which falls within the timeout window. During such occurrences, the HTTP response code will be 202 (i.e., In progress), along with the apiId of the partially created POI. You can monitor the creation status by querying the <a href=Get Custom POI Info > Get Custom POI</a> endpoint.

## Request body

- CreateCustomPoiRequest — Creating <<glossary:Custom POI>> by given name, sub category and polygon/centroid + radius
  - `name` string, required
  - `subCategory` string, required
  - `tagId` string — The Id of the tag that the <<glossary:Custom POI>> is requested to be associated with. If no value is provided, the new POI will not be associated with any tag.
  - `centroid` number[] — List of 2 values that represents the GEO location of the POI center
  - `radius` number, float — Radius (in miles) with which the polygon is constructed when the center of the polygon is the centroid
  - `polygon` array[] — List of pairs ([lng, lat]) that represents the POI polygon
    - number[]
  - `address` object
    - `address` string — Entity Address
    - `city` string — Entity City
    - `zipCode` string — Entity Zip Code

## Response `200`

200 response

- CustomPoiResponse
  - `data` CustomPoiInfo, required
    - `result` string
    - `name` string
    - `apiId` string

## Other responses

- `400` — 400 Bad Request
- `403` — 403 Permission Denied
- `500` — 500 Internal Server Error

---

[API](https://skmtc.net/placer/apis/papi.md) · [All operations](https://skmtc.net/placer/apis/papi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/placer/papi/revisions/e317a0bbbd11/schema)