Notes

Free-form notes attached to a lead or a booking.

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

POST /notes/create

Add a note to a lead or booking.

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

Request body

Field	Type	Required	Description
entityId	string	yes	The lead or booking ID to add the note to
entityType	"lead" | "booking"	yes	Type of entity: 'lead' or 'booking'
text	string	yes	The note text content

Example

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

POST /notes/delete

Delete a note. This action cannot be undone.

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

Request body

Field	Type	Required	Description
noteId	string	yes	The note ID to delete

Example

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

GET /notes/get/booking/{entityId}

List all notes for a specific lead or booking.

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

Path parameters

Name	Type	Required	Description
entityId	string	yes	The lead or booking ID to get notes for

Example

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

Response

Field	Type
notes	any[]
error	boolean

GET /notes/get/lead/{entityId}

List all notes for a specific lead or booking.

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

Path parameters

Name	Type	Required	Description
entityId	string	yes	The lead or booking ID to get notes for

Example

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

Response

Field	Type
notes	any[]
error	boolean