Skip to content
Skip to main content

Notetaker

Nylas Notetaker is a real-time meeting bot that you can invite to your online meetings. It records and transcribes your discussion, and delivers results to you using the Nylas API and webhook notifications.

The /v3/grants/<NYLAS_GRANT_ID>/notetakers endpoints let you interact with Nylas Notetaker while referencing a specific grant so you can use Notetaker's calendar sync features for your authenticated users.

The /v3/notetakers endpoints let you send Notetakers that aren't connected to a grant as standalone Notetakers.

Calendar sync

Notetaker works with the Nylas Calendar API to automatically sync with calendars and events. When you sync Notetaker with a grant's calendar or event, Nylas tracks their join times and meeting links so the Notetaker is always sent to the meeting on time.

Webhook notifications

Nylas sends webhook notifications when a Notetaker bot is created, updated, or deleted, and when the recording media is available.

Endpoints

9
GET
Return all Notetakers
GET /v3/grants/{grant_id}/notetakers

Returns a list of all Notetaker bots.

POST
Invite Notetaker to meeting
POST /v3/grants/{grant_id}/notetakers

Adds a Notetaker bot to the specified meeting. ℹ️ Nylas doesn't de-duplicate Notetaker bots . Every POST /v3/grants/&lt;NYLAS GRANT ID&gt;/notetakers request you make invites a new Notetaker to the sp...

GET
Return a Notetaker
GET /v3/grants/{grant_id}/notetakers/{notetaker_id}

Returns the specified Notetaker bot and its details.

PATCH
Update scheduled Notetaker
PATCH /v3/grants/{grant_id}/notetakers/{notetaker_id}

Updates the specified scheduled Notetaker bot.

DELETE
Delete a Notetaker
DELETE /v3/grants/{grant_id}/notetakers/{notetaker_id}

Permanently deletes the specified Notetaker and all associated data, including any recordings, transcripts, thumbnails, summaries, and action items. This works regardless of the Notetaker's current st...

GET
Return Notetaker history
GET /v3/grants/{grant_id}/notetakers/{notetaker_id}/history

Returns the full history of events and state changes for the specified Notetaker bot.

DELETE
Cancel scheduled Notetaker
DELETE /v3/grants/{grant_id}/notetakers/{notetaker_id}/cancel

Cancels a Notetaker that is in the scheduled state, preventing it from joining the meeting. This endpoint only works for Notetakers that haven't joined a meeting yet. To remove a Notetaker that is cur...

POST
Remove Notetaker from meeting
POST /v3/grants/{grant_id}/notetakers/{notetaker_id}/leave

Sends a request to the specified Notetaker bot to leave the meeting it's currently attending.

GET
Return Notetaker media links
GET /v3/grants/{grant_id}/notetakers/{notetaker_id}/media

Returns a list of links to media generated by the specified Notetaker bot.