Push Meeting Notes

curl --request POST \
  --url https://api.getnexor.ai/api/public/meeting-notes \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "lead_email": "tony.stark@gmail.com",
  "notes": "Revisamos propuesta. Cliente preguntó por plazos de implementación. Budget Q2 aprobado.",
  "manual_ai_summary": "Alta intención. Enterprise. Siguiente paso: propuesta formal antes del viernes."
}
'

{
  "success": true,
  "upserted": false,
  "meeting_note": {
    "id": "0f9230e0-a5e3-4245-8995-afc61007c992",
    "client_id": "2c0911d1-25f9-47c2-8795-fe9407b8d67e",
    "calendar_event_id": "5a76ac77-523d-4100-843c-1105212de877",
    "lead_id": "0433aeee-44af-4148-9ca0-9e2ac41501a7",
    "provider": "manual",
    "external_meeting_id": null,
    "meeting_title": null,
    "meeting_date": "2025-12-29T17:00:00+00:00",
    "duration_seconds": null,
    "organizer_email": null,
    "summary": null,
    "manual_ai_summary": "Alta intención. Siguiente paso: propuesta formal antes del viernes.",
    "transcript_text": "Revisamos propuesta. Budget Q2 aprobado. Interés Enterprise.",
    "action_items": null,
    "questions": null,
    "keywords": null,
    "status": "completed",
    "created_at": "2026-04-15T20:52:35.426356+00:00",
    "updated_at": "2026-04-15T20:52:35.426356+00:00"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

meeting-notes

curl --request POST \
  --url https://api.getnexor.ai/api/public/meeting-notes \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "lead_email": "tony.stark@gmail.com",
  "notes": "Revisamos propuesta. Cliente preguntó por plazos de implementación. Budget Q2 aprobado.",
  "manual_ai_summary": "Alta intención. Enterprise. Siguiente paso: propuesta formal antes del viernes."
}
'

{
  "success": true,
  "upserted": false,
  "meeting_note": {
    "id": "0f9230e0-a5e3-4245-8995-afc61007c992",
    "client_id": "2c0911d1-25f9-47c2-8795-fe9407b8d67e",
    "calendar_event_id": "5a76ac77-523d-4100-843c-1105212de877",
    "lead_id": "0433aeee-44af-4148-9ca0-9e2ac41501a7",
    "provider": "manual",
    "external_meeting_id": null,
    "meeting_title": null,
    "meeting_date": "2025-12-29T17:00:00+00:00",
    "duration_seconds": null,
    "organizer_email": null,
    "summary": null,
    "manual_ai_summary": "Alta intención. Siguiente paso: propuesta formal antes del viernes.",
    "transcript_text": "Revisamos propuesta. Budget Q2 aprobado. Interés Enterprise.",
    "action_items": null,
    "questions": null,
    "keywords": null,
    "status": "completed",
    "created_at": "2026-04-15T20:52:35.426356+00:00",
    "updated_at": "2026-04-15T20:52:35.426356+00:00"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

The note attaches to a calendar_event that already exists in Nexor. There are no orphan notes in v1: if no meeting resolves, you get a 404. Meeting resolution. The endpoint tries the following in order, stopping at the first match:

calendar_event_id (direct).
external_calendar_provider + external_calendar_event_id (matches meetings created via POST /meetings with those dedup keys).
meeting_url (exact match on the calendar_event’s meeting URL).
lead_email + meeting_date (lead’s meeting within ±60 minutes of meeting_date).
lead_email alone (the lead’s most recent past meeting; no time-window floor).

Idempotency. If you supply external_meeting_id together with a provider, replays of the same (provider, external_meeting_id) under your client update the existing row instead of creating duplicates. The timeline note_added activity fires only on the first insert, not on replays. Reserved providers. These values are rejected to protect internal sync pipelines: fireflies, diio, gemini, retell. Pick any other lowercase alphanumeric string (e.g. fathom, granola, otter, manual, zoom_ai). Regex: ^[a-z0-9_-]{1,64}$. Minimum payload: one way to resolve a meeting (calendar_event_id, external_calendar_event_id + external_calendar_provider, meeting_url, or lead_email) and one non-empty content field (notes, transcript_text, summary, manual_ai_summary, or action_items).

Authorizations

X-API-Key

string

header

required

API key for authentication. Keys are prefixed with nxr_live_.

Body

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>

default:completed

Available options:

completed,

pending,

failed

Response

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

Show child attributes

Last modified on June 26, 2026

Quick Start

WhatsApp

Agents

Assistant

Advanced

API Reference

Leads

Agents

Workflow Tools

Client Tools

Groups

Campaigns

Conversions

Reports

Tags

Messages

Background Jobs

Meetings

Team

Processors

Push Meeting Notes

Authorizations

Body

Response