---
title: "Create a Geolocation List Item"
method: POST
path: "/list-item/geolocations"
tags: ["listItems"]
---

# Create a Geolocation List Item

`POST /list-item/geolocations`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/list-item/geolocations`
- Auth: HTTP bearer

Create a new item in a list.

## Query parameters

- `include` string
- `fields` object

## Headers

- `Key-Inflection` 'camel' | 'kebab' | 'snake'
- `Idempotency-Key` string
- `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

## Request body

- object
  - `data` ListItemGeolocationsPostRequestBodyContentApplicationJsonSchemaData
    - `attributes` ListItemGeolocationsPostRequestBodyContentApplicationJsonSchemaDataAttributes
      - `latitude` string: Latitude of the geolocation item (-90 to 90).
      - `list-id` string: ID of the list to add this item to. List must be a Geolocation List.
      - `longitude` string: Longitude of geolocation item (-180 to 180).
      - `radius-meters` string: Radius in meters from point to be considered for match distance.
      - `note` string, nullable: Optional free-text note to attach to the list item. Maximum 255 characters.

## Response `201`

This endpoint returns the created List Item object.

- ListItemsCreateAGeolocationListItemResponse201
  - `data` ListItemGeolocation, required: A Geolocation List Item
    - `id` string: Unique identifier for this list item. Starts with `ligl_`.
    - `type` 'list-item/geolocation'
    - `attributes` ListItemGeolocationAttributes
      - `status` string: Possible values: - pending - active - archived Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
      - `archived-at` string, date-time, nullable
      - `updated-at` string, date-time, nullable
      - `created-at` string, date-time
      - `redacted-at` string, date-time, nullable
      - `match-count` integer
      - `note` string, nullable: Optional free-text note attached to the list item.
      - `inquiry-matches` unknown[]
        - unknown
      - `latitude` number, double
      - `longitude` number, double
      - `radius-meters` integer
    - `relationships` ListItemGeolocationRelationships
      - `creator` ListItemGeolocationRelationshipsCreator
        - `data` union
          - ListItemGeolocationRelationshipsCreatorData0
            - `type` 'user'
            - `id` string
          - ListItemGeolocationRelationshipsCreatorData1
            - `type` 'workflow-run'
            - `id` string
          - ListItemGeolocationRelationshipsCreatorData2
            - `type` 'workflow-step/action'
            - `id` string
          - ListItemGeolocationRelationshipsCreatorData3
            - `type` 'api-key'
            - `id` string
          - ListItemGeolocationRelationshipsCreatorData4
            - `type` 'importer/list-item/geolocation'
            - `id` string

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `404`: The requested resource doesn’t exist.
- `409`: The request conflicts with another request, often due to attempting to create a duplicate resource.
- `422`: The request modifies the resource in an unacceptable way, often due to an invalid action or parameter.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

## Changes

- **2026-10-28** `8dc251058f70`: 2 info
  - added the new optional request property `data/attributes/note`
  - added the optional property `data/attributes/note` to the response with the `201` status

[Operation history](https://skmtc.dev/withpersona/apis/withpersona-3/changes/list-item/geolocations/post.md)

---

[API](https://skmtc.dev/withpersona/apis/withpersona-3.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-3/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-3/revisions/0a3310d5046f?raw)