Saltar al contenido principal
GET /leads//meetings Retorna todas las reuniones (eventos de calendario) de un lead, ordenadas por las más recientes primero. Usa esto para mostrar citas próximas, historial de reuniones pasadas y registros de inasistencia en tu CRM. Autentica cada solicitud con el header X-API-Key. Ver Autenticación.

Parámetros de Ruta

ParámetroTipoRequeridoDescripción
idstring (uuid)ID del lead

Parámetros de Consulta

ParámetroTipoDescripción
statusstringFiltro de estado separado por comas: scheduled, confirmed, completed, cancelled, no_show

Ejemplos

# Todas las reuniones
curl https://api.getnexor.ai/api/public/leads/550e8400-e29b-41d4-a716-446655440000/meetings \
  -H "X-API-Key: nxr_live_your_api_key"

# Solo próximas (agendadas + confirmadas)
curl "https://api.getnexor.ai/api/public/leads/550e8400-e29b-41d4-a716-446655440000/meetings?status=scheduled,confirmed" \
  -H "X-API-Key: nxr_live_your_api_key"

Respuestas

200 Reuniones obtenidas exitosamente

{
  "success": true,
  "meetings": [
    {
      "id": "event-uuid",
      "title": "Intro call with Tony Stark",
      "starts_at": "2026-04-10T15:00:00Z",
      "ends_at": "2026-04-10T15:30:00Z",
      "duration_minutes": 30,
      "timezone": "America/Santiago",
      "status": "scheduled",
      "meeting_url": "https://meet.google.com/abc-xyz-123",
      "location_type": "video",
      "location_details": null,
      "host_name": "Pepper Potts",
      "meeting_type": "Google Meet",
      "attendee_name": "Tony Stark",
      "attendee_email": "tony.stark@gmail.com",
      "confirmed_by_lead": false,
      "cancelled_at": null,
      "cancellation_reason": null,
      "no_show_reason": null,
      "outcome_notes": null,
      "created_at": "2026-04-08T10:00:00Z"
    }
  ]
}

Campos de Respuesta

CampoTipoDescripción
idstring (uuid)Identificador de la reunión
titlestringTítulo de la reunión
starts_atstring (date-time)Hora de inicio (UTC)
ends_atstring (date-time)Hora de fin (UTC)
duration_minutesintegerDuración en minutos
timezonestringZona horaria usada al agendar
statusstringscheduled, confirmed, completed, cancelled o no_show
meeting_urlstring | nullURL de videollamada (Google Meet, Zoom, etc.)
location_typestringvideo, phone o in_person
location_detailsstring | nullInformación adicional de ubicación
host_namestring | nullNombre del anfitrión/agente asignado
meeting_typestring | nullNombre del tipo de reunión (por ejemplo, “Google Meet”, “Initial Consultation”)
attendee_namestringNombre del lead como fue registrado
attendee_emailstringEmail del lead como fue registrado
confirmed_by_leadbooleanSi el lead confirmó asistencia
cancelled_atstring | nullFecha de cancelación de la reunión
cancellation_reasonstring | nullRazón de la cancelación
no_show_reasonstring | nullRazón de la inasistencia (si aplica)
outcome_notesstring | nullNotas posteriores a la reunión
created_atstring (date-time)Fecha de creación de la reunión

401 Error de autenticación

Ver Autenticación.

404 Lead no encontrado

{
  "error": "Lead not found or does not belong to your account"
}

500 Error interno del servidor

Última modificación el 18 de junio de 2026