Microsoft Teams Meeting Recording API
Send a notetaker to any Microsoft Teams meeting from a connected Outlook or Microsoft 365 account. Get the recording, a speaker-attributed transcript, a summary and action items back by webhook.
In closed beta. Contact us to get access.
Microsoft Graph recordings vs a notetaker
Microsoft Graph returns recordings and transcripts after the meeting, for meetings organised inside the tenant, once an administrator has granted the right permissions. A Teams media bot covers the other meetings, but it is a separate workload to host and maintain. The notetaker captures the call itself, internal or external.
| Question | Microsoft Graph | Teams media bot | Unipile notetaker |
|---|---|---|---|
| Who starts the capture | Microsoft GraphRecording or transcription started in the meeting | Teams media botYour own bot | Unipile notetakerOne API request, or the calendar |
| When you get the data | Microsoft GraphAfter the meeting | Teams media botIn your own media pipeline | Unipile notetakerBy webhook, as each artifact is ready |
| Meetings hosted by another company | Microsoft GraphNo, meetings of the tenant only | Teams media botYes | Unipile notetakerYes, from the meeting link |
| Setup for each customer | Microsoft GraphAdmin permissions and change notifications in each tenant | Teams media botHosting, certification and maintenance on your side | Unipile notetakerThe user connects their Microsoft account once |
| Same schema as Google Meet and Zoom | Microsoft GraphNo | Teams media botNo | Unipile notetakerYes |
Graph endpoints: onlineMeeting getAllRecordings and callTranscript get, checked on 12 November 2026. Same request for Google Meet and Zoom.
Record a Teams meeting with one request
Post the Teams meeting URL. Add a future join_at to schedule the capture, reuse the same Idempotency-Key to make retries safe, and attach your own metadata to find the CRM record again.
curl --request POST \ "https://api.unipile.com/v2/$ACCOUNT_ID/notetakers" \ --header "X-API-KEY: $UNIPILE_API_KEY" \ --header "Idempotency-Key: crm-event-8842" \ --header "Content-Type: application/json" \ --data '{ "meeting_url": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_NTg...", "join_at": "2026-10-14T09:00:00Z", "bot_name": "Acme Notetaker", "artifact_settings": { "transcript": { "enabled": true }, "action_items": { "enabled": true } }, "metadata": { "crm_opportunity_id": "8842" } }'
{
"object": "Notetaker",
"id": "nt_01k00000000000000000000000",
"status": "scheduled",
"meeting_provider": "microsoft_teams",
"join_at": "2026-10-14T09:00:00Z",
"metadata": { "crm_opportunity_id": "8842" }
}
meeting_url
Later, with join_at
From the Outlook calendar
Full reference in the developer documentation. Webhooks and artifacts are covered on the Notetaker API overview.
Meetings hosted in another company's tenant
A Teams call organised by a prospect or a candidate never appears in your customer's tenant. The notetaker starts from the meeting link, so it is handled like an internal meeting.
The meeting link is enough
Meetings you host and meetings you are invited to go through the same request.
Lobby-aware status
When the tenant sends guests to the lobby, the job stays in joining and the history says why, so your UI can ask the user to admit the notetaker.
On behalf of your user
Your user must be entitled to be in the call, and participants informed as the law requires.
Capture strategies for locked-down tenants
Enterprise Teams tenants are where recording policies get strict. Choose how capture happens without changing your integration.
cloud
A hosted participant joins the meeting, visible under your product's name. If a tenant keeps external guests out, it cannot join.
extension
Captures the Teams tab of a participant who is already in the call, in their browser. No external guest is added.
auto
Tries the configured sources in order and reports the one that ran in capture_source.
Retention, announcement text and deduplication are set per customer: see the Notetaker API overview.
Teams links from Outlook, recurring series included
Your users schedule Teams calls in Outlook. With calendar automation, the event itself creates the notetaker: nothing to paste anywhere.
Teams link detected on the event
The link Outlook adds to the invitation is enough to schedule the capture. Rules are detailed on the automatic meeting recording page.
One capture per occurrence
Each occurrence of a series gets its own notetaker. A moved or cancelled occurrence moves or cancels its capture.
One Microsoft connection
The same account powers the Outlook Calendar API and the Outlook API, connected once through hosted authentication.
Microsoft Teams recording API: frequently asked questions
Graph, tenants, external meetings and recurring series, answered for developers.
Microsoft Graph exposes Teams recordings and transcripts through endpoints such as callTranscript, after the meeting, for meetings organised inside the tenant and once an administrator has granted the permissions. To get a transcript of the Teams meetings your users attend, including external ones, the Unipile Notetaker API sends a notetaker and returns a speaker-attributed transcript by webhook.
Yes. The notetaker joins from the meeting link, so a meeting hosted in a tenant you have no access to is captured like an internal one, provided your user is entitled to be in the call and participants are informed as the law requires. If the organiser's tenant sends guests to the lobby, someone in the meeting admits the notetaker.
The notetaker runs on the Microsoft account your user connects to Unipile, and the cloud strategy joins from the meeting link as a guest. What a given tenant allows depends on its own policies: some restrict who may join or admit external participants, which the lobby-aware status reports. Contact us to review a specific tenant setup.
Yes. Send a future join_at timestamp to schedule the notetaker, or enable calendar automation on a connected Outlook calendar so that each Teams event creates its own capture.
Yes. With calendar automation enabled on a connected Outlook calendar, each occurrence schedules its own notetaker, and updates to the series are applied automatically.
Graph returns post-meeting artifacts for meetings inside the tenant, after an administrator has configured permissions and change notifications. The Notetaker API captures the call itself, works for external meetings, and returns the same schema as Google Meet and Zoom.
Still have questions? Our team is here to help.
Talk to an expert