Skip to main content
The Plaud group powers the Plaud (Magic Meal Kits) Make.com app. It is a read-only facade over Plaud’s web API: your server holds your Plaud credentials in Secret Manager, so callers only ever send the MMK X-API-KEY header (see Authentication).
Every Plaud endpoint requires a Pro license. A Basic key is rejected with 400 and you are not a magic meal kits PRO user.

​
Endpoints

EndpointTierWhat it does
GET /plaud/user/meProProfile, membership tier, remaining transcription seconds
GET /plaud/filesProList recordings (paginated, sortable)
GET /plaud/files/{id}ProRecording metadata only
GET /plaud/files/{id}/fetchProBundle: file + transcript + summary + share + audio in one call
GET /plaud/files/{id}/transcriptProTranscript (optionally rendered to text/markdown/srt/vtt)
GET /plaud/files/{id}/summaryProAI Markdown summary (images as pre-signed URLs)
GET /plaud/files/{id}/tabsProList named note tabs (Summary, Key Points, …)
GET /plaud/files/{id}/tabs/contentProOne tab’s content, by tab_id or template
GET /plaud/files/{id}/audio-urlProPre-signed S3 URL for the original audio
GET /plaud/devicesProBound Plaud hardware
GET /plaud/searchProFull-text search across transcripts
GET /plaud/search/historyProRecent search queries
GET /plaud/files/webhook-candidatesProPoll ready-to-ship recordings (new-recording trigger)

​
Triggers

The Watch New Note instant trigger in the Make app is delivered by your server’s webhook orchestrator — it is not an endpoint you call. The Watch New Recordings polling trigger reads GET /plaud/files/webhook-candidates, which returns only recordings that are ready (not trashed, transcribed, and summarized).

​
Notes

  • Readiness. Use the is_trans / is_summary flags (on file objects) or the 409 not-ready response to skip recordings whose transcript/summary is still generating.
  • Pre-signed URLs expire. Audio URLs and summary image URLs are short-lived S3 links (~15 minutes) — fetch and use them promptly.
  • One bundle call. Prefer /files/{id}/fetch?include=transcript,summary over three separate round trips when you need multiple attachments for the same recording.
  • Reconnect on 401. A 401 means your stored Plaud credentials were rejected (revoked/expired) — reconnect your Plaud account on the Magic Meal Kits app.
Use the interactive playground on each endpoint page to try a request with your own deployment host and API key.