---
title: "Create a suggestion for a place"
method: POST
path: "/places/v1/{place_handle}/suggestions/"
tags: ["Places"]
---

# Create a suggestion for a place

`POST /places/v1/{place_handle}/suggestions/`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/places/v1/{place_handle}/suggestions/`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/places/v1/:place_handle/suggestions/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a suggestion for a place

## Path parameters

- `place_handle` string, required

## Request body

- SuggestionCreateRequest
  - `geometry` union, required: Suggested location or geofence for this place
    - PointGeometry
      - `coordinates` number[], required: Location coordinates represented as [longitude, latitude]
      - `type` 'Point': Geometry type
    - PolygonGeometry
      - `type` 'Polygon', required: Geometry type
      - `coordinates` array[], required: Location coordinates represented as [[[longitude, latitude], [lon, lat]...]]
        - array[]
          - number[]
  - `radius` integer, nullable: Radius in meters for point geometry suggestions
  - `suggested_by` string, nullable: User who suggested this geofence
  - `order_handle` string, nullable: Order handle associated with this suggestion

## Response `200`

Successful response

- SuggestionResponse
  - `suggestion_id` string, required: Unique identifier for the suggestion
  - `geometry` union, required: Suggested location or geofence for this place
    - PointGeometry
      - `coordinates` number[], required: Location coordinates represented as [longitude, latitude]
      - `type` 'Point': Geometry type
    - PolygonGeometry
      - `type` 'Polygon', required: Geometry type
      - `coordinates` array[], required: Location coordinates represented as [[[longitude, latitude], [lon, lat]...]]
        - array[]
          - number[]
  - `radius` integer, nullable: Radius in meters for point geometry suggestions
  - `hex_id` string, required: Hex ID associated with this suggestion
  - `applied_by` string, nullable: User who applied this suggestion
  - `applied_on` string, nullable: Time when this suggestion was applied
  - `suggested_by` string, nullable: User who suggested this geofence
  - `suggested_on` string, required: Time when this suggestion was made
  - `order_handle` string, nullable: Order handle associated with this suggestion
  - `source` 'ht_generated' | 'customer_provided': Source which created this suggestion
  - `type` string: Type of suggestion (manual, inferred, bounding_box)
  - `skew` number, nullable: Skew between current geofence and suggestion, values can be between 0 and 1. 0 means no skew (perfect overlap) and 1 means no overlap
  - `area_ratio` number, nullable: Ratio of suggested geometry area to current geofence area (suggested/current)
  - `centroid_shift` number, nullable: Distance in meters between the centroid of current geofence and suggestion
  - `inclusivity` string, nullable: More inclusivity means more loosely defined service area

## Other responses

- `400`: Validation error
- `401`: Authentication error
- `404`: Not found

---

[API](https://skmtc.dev/hypertrack/apis/hypertrack-api.md) - [All operations](https://skmtc.dev/hypertrack/apis/hypertrack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hypertrack/apis/hypertrack-api/revisions/389326c4c9c8?raw)