Guests

Guest records and their contact details.

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

POST /guests/delete

Delete a guest profile. This action cannot be undone.

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

Request body

Field	Type	Required	Description
guestId	string	yes	The guest ID to delete

Example

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

POST /guests/edit

Update a guest's profile information.

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

Request body

Field	Type	Required	Description
guestId	string	yes	The guest ID to update
name	string	yes	First name. Core requires it on every update, so send the current value when it is unchanged.
surname	string	yes	Surname. Core requires it on every update, so send the current value when it is unchanged.
email	string	yes	Email address. Core requires it on every update, so send the current value when it is unchanged.
mobile	string	no	Updated mobile number
birthday	number	no	Updated birthday (timestamp ms)
country	string	no	Updated country

Example

curl -X POST 'https://core.mtro.app/guests/edit' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"guestId":"<guestId>","name":"<name>","surname":"<surname>","email":"<email>"}'

POST /guests/register

Create a new guest profile. Required: email, name, surname, password. The password must contain at least 8 characters with an uppercase letter, a lowercase letter, a number, and a special character.

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

Request body

Field	Type	Required	Description
email	string	yes	Guest email address
name	string	yes	Guest first name
surname	string	yes	Guest last name
password	string	yes	Initial account password. At least 8 characters with uppercase, lowercase, a number, and a special character.
mobile	string	no	Guest mobile number
birthday	number	no	Birthday as millisecond timestamp
country	string	no	Guest country
source	string	no	Source of the guest (e.g. LANDING_PAGE, MANUAL)

Example

curl -X POST 'https://core.mtro.app/guests/register' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"email":"<email>","name":"<name>","surname":"<surname>","password":"<password>"}'

POST /guests/search

Search for guests by name, email, or other criteria. Returns matching guest profiles.

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

Request body

Field	Type	Required	Description
search	string	no	Search term matched against guest name, surname, and email. Omit to list every guest.

Example

curl -X POST 'https://core.mtro.app/guests/search' \
  -H 'Authorization: Bearer mtro_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'