Skip to main content

Storing internal invitee data with Custom Query Parameters

Learn how to associate internal data with your events by adding custom query parameters to your Zeeg links.

Written by Fernando Figueiredo

When customers book meetings, you can connect their bookings to specific internal data, like customer IDs. This simplifies the booking process by removing the need to request information you already possess.

Requires Business plan subscription or higher.

How to Use Custom Query Parameters:

Add key-value pairs to your Zeeg links, prefixed with c__.

  • Example: zeeg.me/caroline?c__customer_id=4122123

  • Example: zeeg.me/caroline/30min?c__leadId=HA342

Viewing the information

After the event is booked, you can see the associated information in:

  • The event confirmation email.

  • The event details on your Zeeg dashboard.

  • The webhook payload, if subscribed.

Your Custom Query Parameters and their stored values are also available as variables for Event Notifications and Workflows.


How to filter Scheduled Events by Custom Query Parameter

You can narrow your Scheduled Events list to bookings that carry a specific custom query parameter — useful for finding all meetings tied to a particular customer ID, ticket number, or any other tag you pass in your links.

Filtering by Custom Query Parameters is available on the Business plan or higher. The filter option does not appear on the Events I have scheduled view, which uses a different API endpoint that does not support this filter.

1. Open Scheduled Events in your Zeeg dashboard.

2. Open the filter controls and select Custom Query Parameters from the list of filter options.

3. In the Parameter name box, type the name of the parameter you want to filter on — for example, customer_id or c__customer_id. Both spellings are accepted; Zeeg adds the c__ prefix automatically if you leave it off.

4. Optionally, enter a value in the Exact value box:

  • Leave it empty — the filter returns all bookings where this parameter was present, regardless of its value.

  • Enter a value — the filter returns only bookings where this parameter matches that exact value.

5. The filter chip appears in your filter bar. You can add up to 3 Custom Query Parameter filters at once — the option is hidden from the filter picker once you reach the limit.


Frequently asked questions

What does leaving the value box empty do?

Leaving the Exact value box empty tells Zeeg to return all bookings where that parameter was present — regardless of what value it carried. This is the quickest way to see every booking that came through a link tagged with a particular parameter name.

Why can I only add up to 3 Custom Query Parameter filters?

The API that powers the Scheduled Events listing accepts a maximum of 3 custom query parameter filters per request. Once you have 3 active, the option disappears from the filter picker. Remove one of the existing filters to free up a slot.

The Custom Query Parameters filter option is not visible — why?

Two things can hide the filter option: your plan does not include Custom Query Parameters (Business plan or higher is required), or you are currently viewing the Events I have scheduled list, which does not support this filter. Switch to the main Scheduled Events view and confirm your plan to see the option.

Did this answer your question?