Skip to main content
POST
La nota se adjunta a un calendar_event que ya existe en Nexor. No hay notas huérfanas en v1: si ninguna reunión se resuelve, obtienes un 404. Resolución de reunión. El endpoint intenta lo siguiente en orden, deteniéndose en la primera coincidencia:
  1. calendar_event_id (directo).
  2. external_calendar_provider + external_calendar_event_id (coincide con reuniones creadas vía POST /meetings con esas claves de dedup).
  3. meeting_url (coincidencia exacta con la URL de reunión del calendar_event).
  4. lead_email + meeting_date (reunión del lead dentro de ±60 minutos de meeting_date).
  5. lead_email solo (la reunión pasada más reciente del lead; sin límite de ventana de tiempo).
Idempotencia. Si proporcionas external_meeting_id junto con un provider, repeticiones del mismo (provider, external_meeting_id) bajo tu cliente actualizan la fila existente en lugar de crear duplicados. La actividad note_added en la línea de tiempo solo se dispara en la primera inserción, no en repeticiones. Proveedores reservados. Estos valores se rechazan para proteger los pipelines de sincronización internos: fireflies, diio, gemini, retell. Escoge cualquier otro string alfanumérico en minúsculas (ej. fathom, granola, otter, manual, zoom_ai). Regex: ^[a-z0-9_-]{1,64}$. Payload mínimo: una forma de resolver una reunión (calendar_event_id, external_calendar_event_id + external_calendar_provider, meeting_url, o lead_email) y un campo de contenido no vacío (notes, transcript_text, summary, manual_ai_summary, o action_items).

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Cuerpo

application/json
provider
string

Source of the note. Default manual. Reserved names rejected.

external_meeting_id
string

Stable id from the note-taker (e.g. Fathom Recording ID). Enables idempotent replay. ≤ 255 chars.

calendar_event_id
string<uuid>

Direct link, tier 1 resolution.

external_calendar_provider
string

Pair with external_calendar_event_id, tier 2.

external_calendar_event_id
string

Provider's event id from POST /meetings.

meeting_url
string

Meet / Zoom / Fathom URL, tier 3.

lead_email
string

Matches the lead (client-scoped); also drives tiers 4 & 5.

meeting_date
string

ISO 8601. Used with lead_email for ±60 min fuzzy match.

meeting_title
string
duration_seconds
integer
organizer_email
string

Host email.

notes
string

Raw freeform text. Alias for transcript_text; if both are provided, transcript_text wins. ≤ 1 MB.

transcript_text
string

Full transcript. ≤ 1 MB.

summary
string

Notetaker's native summary (Fathom / Granola / Otter recap).

manual_ai_summary
string

AI-enriched custom summary. Stored separately from summary.

action_items
any[]

["Send pricing", ...] or [{ text, assignee }, ...]. ≤ 512 KB.

questions
any[]

["What's the monthly cost?", ...]. ≤ 512 KB.

keywords
any[]

["pricing", "enterprise", ...]. ≤ 512 KB.

sentences
any[]

Speaker-level utterances (Fireflies-compatible shape). ≤ 512 KB.

status
enum<string>
predeterminado:completed
Opciones disponibles:
completed,
pending,
failed

Respuesta

Created (or 200 on replay upsert)

success
boolean
upserted
boolean

true when a prior row with the same (provider, external_meeting_id) was updated instead of inserted.

meeting_note
object
Última modificación el 10 de julio de 2026