Skip to main content
POST
Log an external meeting
Para cambiar el resultado de una reunión más adelante, usa los endpoints dedicados: Marcar No-Show, Cancelar y Marcar Completada. Coincidencia de leads. Los leads se emparejan por email, con alcance a tu cuenta. Si un lead coincide, se usa; si varios comparten el email, gana el actualizado más recientemente. Pasa lead_id directamente para omitir la coincidencia por email. Si ningún lead coincide, la API responde con 200 OK, success: true, skipped: true y reason: "lead_not_found"; no guarda ninguna reunión. Crea primero el lead con POST /leads antes de reintentar. Horarios y estado de respuesta. El endpoint responde con 200 OK cuando guarda o actualiza una reunión. Si omites timezone, los timestamps sin offset explícito se interpretan en la zona horaria configurada de la cuenta. Los timestamps que incluyen offset conservan el instante indicado. Idempotencia. Si proporcionas tanto external_calendar_provider como external_event_id, repetir la solicitud actualiza la reunión existente en lugar de crear un duplicado. Seguro para reintentos de webhook.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Cuerpo

application/json
title
string
requerido

Meeting title.

starts_at
string
requerido

ISO 8601. If no offset, interpreted in timezone.

lead_email
string

Matcher. Not required if lead_id is provided.

lead_id
string<uuid>

Bypass email matching.

ends_at
string

ISO 8601. Required unless duration_minutes is given.

duration_minutes
integer

Required unless ends_at is given.

timezone
string

IANA timezone. When omitted, naive timestamps use the authenticated account's configured timezone.

meeting_url
string

Meet / Zoom / Teams link.

location_type
enum<string>
predeterminado:video
Opciones disponibles:
video,
phone,
in_person
location_details
string
description
string
host_email
string

Host user email (must be active in your client).

meeting_type_id
string<uuid>
attendee_name
string

Defaults to lead's full name.

attendee_email
string

Defaults to matched email.

attendee_phone
string

Defaults to lead's phone.

additional_attendees
object[]
external_calendar_provider
string

e.g. ghl, google, calendly.

external_event_id
string

Provider's event id (enables dedup).

status
enum<string>
predeterminado:scheduled
Opciones disponibles:
scheduled,
confirmed

Respuesta

Meeting saved or request skipped without writing

success
enum<boolean>
requerido
Opciones disponibles:
true
meeting
object
requerido
Última modificación el 8 de septiembre de 2026