API to get an AI companion generated Transcript

API and Webhooks
1

API Endpoint(s) and/or Zoom API Event(s)

  • POST postmeeting.aic_transcript_completed
  • GET v2/meetings/{meetingId}/transcript

**
Description**
*Need some help with getting transcripts generated by AI companion via API.

This webhook is sending the transcription ready event:* postmeeting.aic_transcript_completed. According to the docs, the file_id is a transcript file but the life of me, I haven’t been able to work out how to download it.

I have tried using {meetingId} and {meetingUUID} to request for the transcript via the endoint below but the response in both cases says the no meeting found. I suspect its due to AI companion generated transcript, so there’s no recording object

GET v2/meetings/{meetingId}/transcript

A steer on this would be super helpful. Thanks.

2

The path that appears to work now is GET /meetings/{meetingId}/transcript, but for AI Companion transcripts you should pass the past meeting instance UUID, not the scheduled meeting ID and not the scheduled UUID from the normal meeting lookup. Zoom still does not spell that distinction out clearly, but it matches the current endpoint behavior discussed on the forum.

The safest flow is to get the occurrence UUID from GET /past_meetings/{meetingId}/instances, then call the transcript endpoint with that value after the meeting has ended. If the UUID contains / or starts with /, double-encode the meeting UUID. Also make sure Allow meeting hosts to retain and access meeting transcripts is enabled, because Zoom ties retained Meeting Summary and AI Companion transcript access to that setting.

One check that usually resolves the “meeting not found” response is to compare the UUID from your normal meeting lookup with the past-instance UUID and retry with the latter. I also would not build around the webhook file_id alone right now, because Zoom does not show a documented download flow from that value for AI Companion transcripts.

If you need a fallback for capturing meeting transcripts, Recall’s Meeting Bot API is an alternative.