Add a person to my account

Create a person in the caller's own account who can be put on a booking but has no login and receives no invitation. Use the returned id as newTravelerId when replacing a traveler. firstName, lastName and dateOfBirth are required. Pass the train bookingId the person is for: a carnet booking only accepts people already in the directory and answers 422 COLLEAGUE_CREATION_UNAVAILABLE.

The create is not idempotent upstream and is never retried by Mercury: after a timeout, check GET /v1/profile/colleagues before creating the person again.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Add a person to the caller's account so they can be put on a booking.

The person has no login and is not invited: they exist only as a named
traveler. Every field below is required before a quote or confirmation
that uses them.

string
required
length between 1 and 80
string
required
length between 1 and 80
date
required

Date of birth; fixes the passenger type the operator prices.

length ≥ 1

Train booking the person is being added for. A carnet booking refuses creation (COLLEAGUE_CREATION_UNAVAILABLE).

Responses

401

Missing or invalid authentication

403

Provider denied the request

404

Booking not found

422

Invalid input, or the booking is a carnet booking (COLLEAGUE_CREATION_UNAVAILABLE)

502

Upstream returned a malformed colleague record

503

Colleague directory is temporarily unavailable

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json