POST/api/v1/meetings/inbox

Meetings inbox (the Google Meet script)

Where the Connect Google Meet script sends one Google Doc: {source: "google-meet-script", file_id, title, created, kind_hint, text, doc_url, backfill}. backfill: true marks a past meeting from the script's backfill: it's imported as history, and nobody is notified about it (its @mentions stay links). The meeting is dated by the date in Google's title, else by created in the connector's time zone. Authenticated with the script's meetings:import token (Bearer mdk_…), which works here and nowhere else and is pinned to one workspace; its owner must still be a member. Idempotent on file_id: returns {status, meeting_id?, url?} with status imported (a new meeting), attached (the other half of a call already in the workspace: notes for a transcript, or the other way round), duplicate (already here: the same Doc, a Doc imported by hand, or the same call by name, date and start time) or ignored (no transcript or notes in it). 401 when disconnected, 403 when no longer a member, 409 while the same Doc is being imported, 413 over 1,500,000 characters, 422 for a malformed delivery. Rate limited per token: 30 a minute, 600 a day.

API token required600 per day per IP30 per minute per IP

Guide: Import meetings automatically

Code samples and Try it

Request body

application/json, required

source"google-meet-script"
Default "google-meet-script".
file_idstringRequired
1–200 characters.
titlestring
Shown on the page and in link previews. Up to 500 characters.
createdstring
Up to 40 characters.
kind_hint"transcript" | "notes"
textstringRequired
doc_urlstring
Up to 500 characters.
backfillboolean
Default false.

Responses

200OK.
401No token, or the token is revoked or mistyped.
429Too many requests from your IP address. Wait the seconds in Retry-After.

curl -X POST https://api.markdrop.in/api/v1/meetings/inbox \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "source": "google-meet-script", "file_id": "1AbCdEfGhIjKlMnOpQrStUvWxYz", "title": "Weekly sync (2026-11-04 10:00 GMT+05:30) - Transcript", "created": "2026-11-04T05:20:00.000Z", "kind_hint": "transcript", "text": "Ada Lovelace: Let'\''s ship on Friday.\nBo Chen: Agreed.", "doc_url": "https://docs.google.com/document/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit" }'

const res = await fetch("https://api.markdrop.in/api/v1/meetings/inbox", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "source": "google-meet-script", "file_id": "1AbCdEfGhIjKlMnOpQrStUvWxYz", "title": "Weekly sync (2026-11-04 10:00 GMT+05:30) - Transcript", "created": "2026-11-04T05:20:00.000Z", "kind_hint": "transcript", "text": "Ada Lovelace: Let's ship on Friday.\nBo Chen: Agreed.", "doc_url": "https://docs.google.com/document/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit" }), }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/meetings/inbox", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "source": "google-meet-script", "file_id": "1AbCdEfGhIjKlMnOpQrStUvWxYz", "title": "Weekly sync (2026-11-04 10:00 GMT+05:30) - Transcript", "created": "2026-11-04T05:20:00.000Z", "kind_hint": "transcript", "text": "Ada Lovelace: Let's ship on Friday.\nBo Chen: Agreed.", "doc_url": "https://docs.google.com/document/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit", }, ) r.raise_for_status() print(r.json())