---
title: "Create Location Reminder"
method: POST
path: "/api/v1/location_reminders"
tags: ["Location reminders"]
---

# Create Location Reminder

`POST /api/v1/location_reminders`

Create a new location reminder for a task.

## Request body

- Body4c96330f
  - `task_id` string, required — String ID of the task
  - `name` string, required — Name of the location
  - `loc_lat` string, required — Latitude of the location
  - `loc_long` string, required — Longitude of the location
  - `loc_trigger` 'on_enter' | 'on_leave', required — Trigger type: 'on_enter' or 'on_leave'
  - `radius` integer — Radius in meters (default 100, max 255)

## Response `200`

Successful Response

- NotificationLocationSyncView — A class with fields representing a NotificationLocationView which will be returned to clients in a sync-like response.
  - `id` string, required — String ID of the location reminder
  - `item_id` string, required — String ID of the task
  - `project_id` string, required — String ID of the project containing the task
  - `notify_uid` string, required — String ID of the user who will receive the reminder
  - `name` string, required — Name of the location
  - `loc_lat` string, required — Latitude of the location
  - `loc_long` string, required — Longitude of the location
  - `loc_trigger` 'on_enter' | 'on_leave', required — Trigger type for the location reminder
  - `radius` integer, required — Radius in meters
  - `is_deleted` boolean, required — Whether the location reminder is deleted
  - `type` 'location' — The reminder type

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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