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

# Log a Meeting

> Log a meeting booked in an external system (e.g. GoHighLevel, Calendly, manual reps) against an existing Nexor lead. The meeting appears in the lead's timeline and in `GET /leads/{id}/meetings`.

To change a meeting's outcome later, use the dedicated endpoints: **Mark as No-show**, **Cancel**, and **Mark as Completed**.

**Lead matching.** Leads are matched by `email`, scoped to your client. If one lead matches it is used; if multiple share the email the most recently updated wins; if none match you get a `404` (create the lead first via `POST /leads`). Pass `lead_id` directly to skip email matching.

**Idempotency.** If you supply both `external_calendar_provider` and `external_event_id`, replaying the request updates the existing meeting instead of creating a duplicate. Safe for webhook retries.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).