> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Booking links and leads

> Publish booking links and follow a signup through CRM and trial booking.

Select the `booking_links` module on a company or coach connection. The
booking-link and signup tools need the booking-links feature and company-wide
location access. The location-based CRM tools use the coach's assigned
locations and current CRM permissions. Each change requires a separate write
grant, explicit confirmation, and an idempotency key.

| Tool | What it does |
| - | - |
| `list_leads_by_location` | List all CRM leads at a location, including other acquisition sources and archived leads. |
| `update_lead_contact` | Correct a lead's name, email, phone number, or dialing code. |
| `move_lead_to_location` | Assign a lead to another permitted active location. |
| `list_booking_links` | List links by status or audience with page and limit. |
| `get_booking_link` | Read the shareable URL and the operational configuration of one link. |
| `create_booking_link` | Create an inactive draft or publish a link with the selected audience and calendar templates. |
| `update_booking_link` | Edit the selected settings or deactivate the link while preserving its signups. |
| `list_booking_link_leads` | Find the trial signups for a link and their CRM lead and booking IDs. |
| `get_booking_link_signup` | Review one trial signup and its contact and booking details. |
| `update_booking_link_signup` | Set the slot request status, cancel a signup, or archive it. |
| `open_booking_link_lead` | Open the CRM lead for an unlinked signup. |
| `get_booking_link_lead` | Read a CRM lead's contact details, stage and follow-up. |
| `get_booking_link_lead_stages` | Read configured stage and loss-reason keys. |
| `update_booking_link_lead` | Assign, move, archive, or schedule follow-up for a lead. |
| `add_booking_link_lead_note` | Record a follow-up note on the lead. |
| `book_booking_link_lead_trial` | Confirm a trial in a selected existing calendar slot. |

Page through links using the response's `pagination`. For link signups, reuse
`nextCursor` with the same `bookingLinkId` until `hasMore` is false.
One lead can have more than one signup. When `leadId` is empty, the signup has
no linked CRM lead at the time of the read. Use `open_booking_link_lead`
when a coach wants to follow up on that signup.

Use `list_event_templates` and `list_locations` to discover lesson and
location IDs. Trial and direct-signup links require a valid product. For a
trial booking, look up the calendar event and occurrence first, then confirm
the lead, lesson, time, and whether the signup should receive a notification.

## Manage CRM leads by location

Find the location ID with `list_locations` and pass it as `locationId` to
`list_leads_by_location`. The list includes leads in all stages and archived
leads. Follow `nextCursor` with the same location until `hasMore` is false.
Each page has up to 50 leads. Use `locationId: "unassigned"` to find leads
without a location when the coach has company-wide location access.

For a contact update, pass the lead ID and its current `locationId`. For a
move, pass its ID, `sourceLocationId`, and `destinationLocationId`. Use
`null` for a lead with no current location. Moving a lead requires access to
both locations. A lead move changes its CRM assignment and preserves existing
trial appointments. Contact edits apply to the CRM record.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.