Reminders

Scheduled reminders attached to a lead or a booking.

6 endpoints. Every request needs an Authorization: Bearer mtro_... header, and responses follow the envelope described in Errors and conventions.

POST /reminders/create

Create a reminder for a lead or booking.

Required scope: any valid API key for the entity.
MCP tool: reminders_create

Request body

Field	Type	Required	Description
entityId	string	yes	The lead or booking ID
entityType	"lead" | "booking"	yes	Type of entity: 'lead' or 'booking'
title	string	yes	Reminder title
note	string	no	Additional notes for the reminder
reminderDate	number	yes	When to trigger the reminder (timestamp ms)

Example

curl -X POST 'https://core.mtro.app/reminders/create' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"entityId":"<entityId>","entityType":"<entityType>","title":"<title>","reminderDate":0}'

POST /reminders/delete

Delete a reminder. This action cannot be undone.

Required scope: any valid API key for the entity.
MCP tool: reminders_delete

Request body

Field	Type	Required	Description
reminderId	string	yes	The reminder ID to delete

Example

curl -X POST 'https://core.mtro.app/reminders/delete' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"reminderId":"<reminderId>"}'

GET /reminders/get/all

List all reminders across all leads and bookings.

Required scope: any valid API key for the entity.
MCP tool: reminders_list

Example

curl -X GET 'https://core.mtro.app/reminders/get/all' \
  -H 'Authorization: Bearer mtro_your_api_key'

Response

Field	Type
reminders	object[]
error	boolean

Fields of reminders[]

Field	Type
id	string
entityId	string
entityType	string
title	string
note	string
createdAt	integer
reminderDate	integer
completed	boolean
completedAt	any

GET /reminders/get/booking/{entityId}

List all reminders for a specific lead or booking.

Required scope: any valid API key for the entity.
MCP tool: reminders_list_by_entity

Path parameters

Name	Type	Required	Description
entityId	string	yes	The lead or booking ID

Example

curl -X GET 'https://core.mtro.app/reminders/get/booking/<entityId>' \
  -H 'Authorization: Bearer mtro_your_api_key'

Response

Field	Type
reminders	any[]
error	boolean

GET /reminders/get/lead/{entityId}

List all reminders for a specific lead or booking.

Required scope: any valid API key for the entity.
MCP tool: reminders_list_by_entity

Path parameters

Name	Type	Required	Description
entityId	string	yes	The lead or booking ID

Example

curl -X GET 'https://core.mtro.app/reminders/get/lead/<entityId>' \
  -H 'Authorization: Bearer mtro_your_api_key'

Response

Field	Type
reminders	any[]
error	boolean

POST /reminders/update

Update a reminder. Can mark as completed, change date, title, or notes.

Required scope: any valid API key for the entity.
MCP tool: reminders_update

Request body

Field	Type	Required	Description
reminderId	string	yes	The reminder ID to update
title	string	no	Updated title
note	string	no	Updated notes
reminderDate	number	no	Updated reminder date (timestamp ms)
completed	boolean	no	Mark as completed (true) or uncompleted (false)

Example

curl -X POST 'https://core.mtro.app/reminders/update' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"reminderId":"<reminderId>"}'