API & Zapier
API & Zapier
Elke recap die InterMIND produceert, kan direct in de tool belanden waarin je werkt — je CRM, helpdesk, taaktracker of een spreadsheet — zonder dat iemand het met de hand hoeft over te typen. Twee manieren om dit te doen:
- Zapier (zonder code): verbind InterMIND eenmalig met een API-sleutel en bouw vervolgens Zaps op de Meeting Recap Ready-trigger en de Create Meeting Link-actie. Dezelfde integratie werkt ook vanuit Make, n8n of Pipedream via hun algemene webhook- en HTTP-modules, met behulp van de onderstaande API.
- De API (voor ontwikkelaars): een persoonlijke sleutel, één webhook-event en drie endpoints.
Beschikbaar voor: elk geregistreerd account. Gasten kunnen geen sleutels aanmaken. Waar: Settings → API keys.
API-sleutels
- Open Settings en vind de kaart API keys.
- Klik op Create key, geef het een label (de tool die het zal gebruiken, bijv. "Zapier") en kopieer de sleutel. Het begint met
imk_en wordt één keer getoond — InterMIND slaat alleen een hash op. - Trek een sleutel op elk moment in vanuit dezelfde kaart. Webhook-abonnementen die met die sleutel zijn aangemaakt, stoppen onmiddellijk.
Maximaal 10 sleutels per account. Stuur de sleutel als een bearer-token:
Authorization: Bearer imk_…
Sleutels werken alleen op de /api/v1-endpoints hieronder; ze geven nooit toegang tot de eigen API van de webapplicatie.
Zapier
- Voeg in Zapier de InterMIND-app toe aan een Zap en plak je API-sleutel wanneer hierom wordt gevraagd. De verbinding wordt gelabeld met jouw account-e-mailadres.
- Trigger Meeting Recap Ready — vuurt één keer per afgeronde meeting die jij hebt gehost, zodra de samenvatting klaar is. Velden: meetingtitel en link, recap-link, transcript-link, de samenvatting in Markdown, samenvattingstaal, start- en eindtijd, deelnemers (naam, e-mail), host.
- Actie Create Meeting Link — maakt een ad-hoc meeting aan waarvan jij de eigenaar bent en retourneert de URL. Plaats het in een CRM-deal, een support-ticket of een agenduitnodiging; iedereen die de link opent, klopt aan en je keurt ze goed in de ruimte.
Typische Zaps: recap → nieuwe notitie op de HubSpot-deal; recap → interne opmerking op het Zendesk-ticket; recap → rij in Google Sheets; nieuwe Pipedrive-deal → meeting-link teruggestuurd naar de deal.
Endpoints
Base-URL: https://intermind.com/api/v1. Alle antwoorden zijn JSON. Machineleesbaar contract (OpenAPI 3.1, voor Make, n8n, Pipedream en AI-agents): https://intermind.com/api/v1/openapi.json.
| Method | Path | Purpose |
|---|---|---|
GET | /me | Wie eigenaar is van de sleutel: { id, email, name } |
POST | /meetings | Maak een ad-hoc meeting-link aan. Body { "title": "…" } (optioneel). Retourneert 201 { id, url, title, created_at } |
GET | /recaps?limit=3 | Jouw nieuwste recaps (1–10), nieuwste eerst, in de webhook-payloadstructuur |
GET | /webhooks | Jouw webhook-abonnementen |
POST | /webhooks | Abonneer: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Abonnement opzeggen → 204 |
Limieten: 10 sleutels en 20 webhook-abonnementen per account. target_url moet https:// zijn en publiekelijk bereikbaar — privénetwerkadressen worden geweigerd.
Webhook: recap.ready
Verzonden als POST-JSON naar elk geabonneerde target_url zodra een recap voor een meeting die jij hebt gehost is afgerond met een niet-lege samenvatting. Het wordt één keer per meetingsessie verzonden. Headers:
| Header | Value |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Uniek id van dit event (<meeting id>.<session id>) — dedupliceer hierop |
X-InterMIND-Signature | sha256=<HMAC-SHA256 van de raw body met het geheim van het abonnement> |
User-Agent | InterMIND-Webhooks/1 |
Payload:
{
"id": "abc-def-ghi.conf_01",
"event": "recap.ready",
"occurred_at": "2026-09-04T10:32:11.000Z",
"meeting": { "id": "abc-def-ghi", "title": "Weekly sync with Acme", "url": "https://intermind.com/abc-def-ghi", "type": "adhoc" },
"recap": {
"url": "https://intermind.com/r/abc-def-ghi/…",
"transcript_url": "https://intermind.com/t/abc-def-ghi/…",
"summary_md": "## Decisions\n- …",
"language": "en"
},
"session": { "started_at": "2026-09-04T10:00:03.000Z", "ended_at": "2026-09-04T10:31:40.000Z" },
"participants": [{ "name": "Anna Müller", "email": "anna@acme.example" }],
"host": { "name": "Anna Müller", "email": "anna@acme.example" }
}
Bezorgingsregels: jouw endpoint moet binnen 8 seconden antwoorden met 2xx. Bij een netwerkfout, 5xx of 429 wordt direct één keer opnieuw geprobeerd. Een 410 of 404 verwijdert het abonnement. Elke andere fout wordt gelogd en het event wordt niet opnieuw verzonden — de recap-e-mail en de recap-pagina blijven de duurzame vastlegging. Recap- en transcript-links zijn toegankelijk voor meetingsdeelnemers die zijn ingelogd.