Embedding

Quick start

Add an iframe to your page pointing to your brand's scheduling URL with ?embed=1:

<iframe
  src="https://{subdomain}.endear.events?embed=1"
  allow="clipboard-write"
></iframe>

Replace {subdomain} with your brand's subdomain.

The embed=1 parameter is required. It tells the scheduler to render in embedded mode — links open in new tabs instead of navigating away from your page, and booking confirmations display inline rather than redirecting.

Root page views

The root URL defaults to listing your locations. You can change the view by using a different path:

Path	Description
`/locations`	Lists locations (teams), sorted by proximity to the visitor. Default
`/services`	Lists appointment types (event types)
`/staff`	Lists available staff members

<iframe
  src="https://{subdomain}.endear.events/services?embed=1"
  allow="clipboard-write"
></iframe>

After selecting a location, service, or staff member, the visitor is shown the matching appointment booking pages and can proceed to book.

Filtering

You can pre-filter the list by passing query parameters:

Parameter	Description
`event-type`	Show booking pages for a specific appointment type
`team`	Show booking pages for a specific team (location ID)
`username`	Show booking pages for a specific user (user ID)

<iframe
  src="https://{subdomain}.endear.events/locations?embed=1&team={teamId}"
  allow="clipboard-write"
></iframe>

When a filter is applied, the page skips the initial list and shows the matching booking pages directly.

Linking to a specific booking page

To link directly to a specific booking page, use the booking path:

<iframe
  src="https://{subdomain}.endear.events/book/{appointmentTypeId}/{slug}?embed=1"
  allow="clipboard-write"
></iframe>

You can find the appointmentTypeId and slug from your Appointment Settings in Endear.

Prefilling form fields

You can prefill the booking form by passing customer data as query parameters. This is useful when you already know information about the customer (e.g., they are logged in to your site).

Parameter	Description
`first_name`	Customer's first name
`last_name`	Customer's last name
`email_address`	Customer's email address
`phone_number`	Customer's phone number

<iframe
  src="https://{subdomain}.endear.events?embed=1&first_name=Jane&last_name=Doe&email_address=jane%40example.com"
  allow="clipboard-write"
></iframe>

Prefilled fields appear pre-populated in the form. The customer can still edit them before submitting.