--- title: "Usage Guide: Automatically Add or Update a registered person on a trip using addregistration API endpoint or Zapier" description: - --- [Skip to content](https://support.youli.io/how-to-automatically-add-person-registration-via-zapier-or-api-to-trip#main-content) [Open Ticket](https://support.youli.io/kb-tickets/new?hsLang=en) [Customer portal](https://support.youli.io/feature-request-tickets-view?hsLang=en) [![YouLi Support](https://support.youli.io/hs-fs/hubfs/Logo%20White.png?width=100&height=75&name=Logo%20White.png)](https://support.youli.io/?hsLang=en) - [Pricing](https://go.youli.io/pricing) - [Book Demo](https://go.youli.io/youli-demo-videos) - [Blog](https://blog.youli.io/) Open main navigation Close main navigation - [Pricing](https://go.youli.io/pricing) - [Book Demo](https://go.youli.io/youli-demo-videos) - [Blog](https://blog.youli.io/) - [Open Ticket](https://support.youli.io/kb-tickets/new) - [Customer portal](https://support.youli.io/feature-request-tickets-view) - [Open Ticket](https://support.youli.io/kb-tickets/new) [Open Ticket](https://support.youli.io/kb-tickets/new?hsLang=en) How can we help you? - There are no suggestions because the search field is empty. 1. [Help Center](https://support.youli.io/?hsLang=en) 2. [How-To](https://support.youli.io/how-to?hsLang=en) 3. [API](https://support.youli.io/how-to?hsLang=en#api) # Usage Guide: Automatically Add or Update a registered person on a trip using addregistration API endpoint or Zapier ## Sometimes people register to book from another platform, add them (or update them) automatically using this API endpoint. Available Plans: **PRO and above** For this endpoint, "invitee" refers to the traveler registered on the trip. You can get the inviteeId from registration webhooks or the `getinvitee` endpoint. [https://youlivetotravel.github.io/youli-doco/](https://youlivetotravel.github.io/youli-doco/) This endpoint can be accessed either directly via the API or through Zapier. ### Add or Update Registration You can do this via the UI from [Trip CRM](https://support.youli.io/360000952895-get-started-add-a-person-to-a-public-or-private-trip?hsLang=en), or use this endpoint directly or via Zapier to add a person as registered to a TRIP in YouLi. While **registration** is required to book, creating the registration only makes them **booked** if: - The package they are registered on is $0 or they have a personalized price of $0 - They have made a payment - You can also [add a manual payment via API](https://support.youli.io/4412041306511-how-to-add-a-manual-payment-for-a-traveler?hsLang=en) if one has been made - Or they can click to the invoice generated by the registration from the confirmation email that is automatically send `POST /api/trip/addregistration` 1. `tripId`  1. Required 1. `email` 1. Required 2. Zapier: Required 3. Must be a valid email 2. `ForceNewRegistration` **(boolean)** - When true, skip the existing "match by email" lookup entirely and always create a new invitee, even if the email already exists on the trip.   1. `AllowEmptyEmail` **(boolean)** - When true, **Email** is no longer a required field. - The match-by-email lookup is only skipped when the email is actually blank (i.e. this flag relaxes the required-field rule; it doesn't change matching behavior when a real email is supplied). If AllowEmptyEmail=true and a non-blank email is sent that matches an existing invitee, normal update behavior still applies. That behavior shall be controlled by ForceNewRegistration, not **AllowEmptyEmail**. 2. `InvitationGroup` **(string)** - If an invitation group with this name already exists on the trip, add the invitee to it. - If it doesn't exist, create a new invitation group with this name, default to "Paying Together", and add the invitee to it. - If not provided, don't touch the invitee's group assignment. - If they’re already in a group, leave them there - If they’re NOT, leave them as solo traveler - Value returned in the response as `InvitationGroup` - `` `` 3. `ReservationNumber` **(string)** - Reservation is not scoped to a single trip: a tour can be structured as a **Main Tour** with an optional linked **Pre-Trip** and **Post-Trip**, and a Reservation can span gangs across all three. When resolving ReservationNumber, if the trip being registered against is a Main Tour, a Pre-Trip, or a Post-Trip, the lookup will also search on the **other linked trips** - If a match is found (on the current trip or either linked trip), attach the invitee to that existing reservation. - If the provided value doesn't match any reservation on the current trip or its linked pre/post trips, return a 400 with alert email sent: "Reservation number {value} not found". - Ignored if `IsNewReservation` is also set (see below).   4.  `IsNewReservation` **(boolean)** - Optional; defaults to **false** if not set - Set this flag to **true** to create a new ReservationNumber - When set to true, `ReservationNumber` is ignored - This will then be returned so you can add more people to the reservation 5. `CategoryName` **(string)** 1. Optional; defaults to 'None' or the [Traveler Category](https://support.youli.io/how-to-assign-your-traveler-to-a-category?hsLang=en) connected to the allocated [Package](https://support.youli.io/360001960716-how-to-understand-and-set-up-your-pricing-packages?hsLang=en) 2. Pass a string that matches an existing configured Traveler Category, for example 'Student' ### Troubleshooting Any detailed errors will be sent to email configured on the account to receive API errors Request  - [Get Started](https://support.youli.io/get-started?hsLang=en#main-content) - [Checklists](https://support.youli.io/get-started?hsLang=en#checklists) - [Setting up your account](https://support.youli.io/get-started?hsLang=en#setting-up-your-account) - [Setting up your Trip Page](https://support.youli.io/get-started?hsLang=en#setting-up-your-trip-page) - [Video Tutorials](https://support.youli.io/get-started?hsLang=en#video-tutorials) - [Trip Registration](https://support.youli.io/get-started?hsLang=en#trip-registration) - [Emails](https://support.youli.io/get-started?hsLang=en#emails) - [Packages & Installments](https://support.youli.io/get-started?hsLang=en#packages-installments) - [Payments](https://support.youli.io/get-started?hsLang=en#payments) - [Adding & Managing People](https://support.youli.io/get-started?hsLang=en#adding-managing-people) - [Starter Website](https://support.youli.io/get-started?hsLang=en#starter-website) - [How-To](https://support.youli.io/how-to?hsLang=en#main-content) - [Technology Partners](https://support.youli.io/how-to?hsLang=en#technology-partners) - [API](https://support.youli.io/how-to?hsLang=en#api) - [Reports](https://support.youli.io/how-to?hsLang=en#reports) - [YouLi Plan Add-ons](https://support.youli.io/how-to?hsLang=en#youli-plan-add-ons) - [Affiliates](https://support.youli.io/how-to?hsLang=en#affiliates) - [Payments](https://support.youli.io/how-to?hsLang=en#payments) - [Video Tutorials](https://support.youli.io/how-to?hsLang=en#video-tutorials) - [Website Integration](https://support.youli.io/how-to?hsLang=en#website-integration) - [Mobile App](https://support.youli.io/how-to?hsLang=en#mobile-app) - [White Label App](https://support.youli.io/how-to?hsLang=en#white-label-app) - [Account Roles](https://support.youli.io/how-to?hsLang=en#account-roles) - [Tasks](https://support.youli.io/how-to?hsLang=en#tasks) - [Packages](https://support.youli.io/how-to?hsLang=en#packages) - [Highlights, Itinerary & Optional Add-ons](https://support.youli.io/how-to?hsLang=en#highlights-itinerary-optional-add-ons) - [Invitation Groups](https://support.youli.io/how-to?hsLang=en#invitation-groups) - [Coupons](https://support.youli.io/how-to?hsLang=en#coupons) - [Trip Page Menu](https://support.youli.io/how-to?hsLang=en#trip-page-menu) - [Integrating Cruise Deck Plans](https://support.youli.io/how-to?hsLang=en#integrating-cruise-deck-plans) - [Managing Trip Dashboard](https://support.youli.io/how-to?hsLang=en#managing-trip-dashboard) - [Emails](https://support.youli.io/how-to?hsLang=en#emails) - [Bookings](https://support.youli.io/how-to?hsLang=en#bookings) - [Managing People](https://support.youli.io/how-to?hsLang=en#managing-people) - [Registration](https://support.youli.io/how-to?hsLang=en#registration) - [PDF Confirmation](https://support.youli.io/how-to?hsLang=en#pdf-confirmation) - [Documents](https://support.youli.io/how-to?hsLang=en#documents) - [Billing](https://support.youli.io/how-to?hsLang=en#billing) - [New Features](https://support.youli.io/new-features?hsLang=en#main-content) - [Recent Releases](https://support.youli.io/new-features?hsLang=en#recent-releases) - [Past Releases](https://support.youli.io/new-features?hsLang=en#past-releases) - [Enterprise Clients](https://support.youli.io/enterprise-clients?hsLang=en#main-content) - [Enterprise Onboarding](https://support.youli.io/enterprise-clients?hsLang=en#enterprise-onboarding) - [Enterprise-only Features](https://support.youli.io/enterprise-clients?hsLang=en#enterprise-only-features) - [FAQ](https://support.youli.io/faq?hsLang=en#main-content) - [Data Security](https://support.youli.io/faq?hsLang=en#data-security) - [Payments](https://support.youli.io/faq?hsLang=en#payments) - [YouLi Account](https://support.youli.io/faq?hsLang=en#youli-account) - [Emails](https://support.youli.io/faq?hsLang=en#emails) - [Managing People](https://support.youli.io/faq?hsLang=en#managing-people) - [Packages](https://support.youli.io/faq?hsLang=en#packages) - [YouLi Subscription Plans](https://support.youli.io/faq?hsLang=en#youli-subscription-plans) - [Tasks](https://support.youli.io/faq?hsLang=en#tasks) - [Reporting](https://support.youli.io/reporting?hsLang=en) - [YouLi User Roles](https://support.youli.io/youli-user-roles?hsLang=en) - [For Travelers](https://support.youli.io/for-travelers?hsLang=en) - [Partners](https://support.youli.io/partners?hsLang=en) - [Upcoming Features](https://support.youli.io/upcoming-features?hsLang=en) - [Incidents](https://support.youli.io/incidents?hsLang=en) - [Contact Us](https://support.youli.io/contact-us?hsLang=en) [![YouLi Marketing Site](https://support.youli.io/hs-fs/hubfs/Logo%20Default.png?width=55&height=24&name=Logo%20Default.png "YouLi Marketing Site")](https://go.youli.io) ### Need more help?  Reach out to the YouLi Support team via the **Chat** icon at the bottom-right corner of your screen: ![Screenshot 2026-07-22 at 12.27.38 PM](https://support.youli.io/hs-fs/hubfs/Screenshot%202026-07-22%20at%2012.27.38%20PM.png?width=268&height=111&name=Screenshot%202026-07-22%20at%2012.27.38%20PM.png) or [submit a Support Ticket.](https://support.youli.io/kb-tickets/new?hsLang=en) Copyright © 2025, YouLi Travel Pty. Ltd