API & Webhooks

Bouw voort op je gesprekken

Een REST API om je opnames op te vragen en het transcript, het rapport en het mediabestand naar je eigen tools te halen. Een Zapier-trigger zodra een rapport klaar is. Eén sleutel in een header, en je bent binnen.

Hoe het werkt

Van sleutel tot pipeline

Opvragen, ophalen, reageren: zo krijgen je tools wat een vergadering heeft opgeleverd, in drie stappen.

01

Vraag je opnames op

Eén sleutel in de X-API-Key-header. GET /record geeft je opnames terug met status, titel, contacten en vergaderlink, gefilterd op datum, status of eigenaar, gepagineerd per cursor.

02

Haal transcript en rapport op

GET /transcript geeft je elke regel met de spreker en de tijdstempels. GET /report geeft je het AI-rapport in HTML of platte tekst, op basis van het sjabloon waarmee het is gemaakt. Het mediabestand komt als ondertekende link, 24 uur geldig.

03

Reageer zodra een rapport klaar is

De Zapier-trigger New Report gaat af zodra een vergadering is verwerkt, met het transcript, de samenvatting, de scorekaart en de audiolink. Stuur hem door naar Notion, je CRM, een Slack-kanaal of je eigen endpoint.

De REST API

Vijf endpoints, alles wat een vergadering opleverde

Bewust klein gehouden. Je sleutel in de X-API-Key-header, JSON erin, JSON eruit, en een Swagger UI om elke call te testen voordat je een regel code schrijft.

Je eerste call

$ curl "https://api.noota.io/api/v1/record?limit=5" \
  -H "X-API-Key: $NOOTA_API_KEY"

GET

/api/v1/record
01

Opnames opvragen

Filters: start_date, end_date, status (transcribed, uploaded, processing, all), email. 1 tot 25 per pagina, paginering per cursor.

GET

/api/v1/transcript/{id}
02

Transcript ophalen

Titel, duur, deelnemers en elke regel met speaker_name, start, end en text.

GET

/api/v1/report/{id}
03

AI-rapport ophalen

format=html of plaintext. Titel, categorie, inhoud, eigenaar, contacten en vergader-URL.

GET

/api/v1/record/{id}/file
04

Media downloaden

Een ondertekende URL naar het audio- of videobestand, 24 uur geldig.

DELETE

/api/v1/record/{id}
05

Opname verwijderen

Verwijdert de opname en de bijbehorende gegevens. Geeft 204 terug.

Drie manieren om te bouwen

Ophalen, laten doorsturen of een assistent laten vragen

Van aanmelding tot een teamwerkruimte, in je eigen tempo.

01
REST-API

Haal opnames, transcripten, rapporten en media naar je eigen tools, wanneer het jou uitkomt. Eén sleutel, één header.

02
Zapier: trigger en acties

Gaat af zodra een nieuw vergaderrapport klaarstaat in Noota. Met het transcript, de samenvatting, de scorekaart en de audiolink.

03
MCP, met OAuth 2.0

Laat Claude, ChatGPT of je eigen agent via de MCP-server in je vergaderingen zoeken. Authorization code met PKCE, leesscope, refresh tokens, dynamische clientregistratie.

5

REST-endpoints: opnames, transcript, rapport, mediabestand, verwijderen

11

Zapier-blokken: de trigger New Report en tien acties

24

geldigheid van een ondertekende medialink

1

header om je te authenticeren: X-API-Key. Geen SDK nodig

Kleine API, alles wat je nodig hebt

Wat je kunt ophalen, wat er naar je toe komt en wat van jou blijft.

Eén sleutel, één header

X-API-Key bij elke aanroep. Geen SDK te installeren, elke taal die HTTPS spreekt.

Alles wat een vergadering oplevert

Opnames, transcripten met sprekers en tijdstempels, AI-rapporten, mediabestanden.

Eventgestuurd met Zapier

New Report gaat af zodra de vergadering is verwerkt. Meer dan 5.000 apps aan de andere kant, of een webhook naar je eigen endpoint.

OAuth 2.0 voor assistenten

Hetzelfde platform autoriseert de MCP-server: authorization code met PKCE, leesscope, refresh tokens.

Gedocumenteerd en live

De OpenAPI-specificatie en een Swagger UI op api.noota.io/docs. Probeer een aanroep voordat je één regel schrijft.

Gehost in Europa

Je data blijft op Europese infrastructuur. Verwijder op elk moment een opname via de API.

Zij verwoorden het beter

“Noota heeft de manier waarop ik mijn tools beheer veranderd. Dankzij geautomatiseerde integraties zijn onze projecten nu echt uitvoerbaar, met directe impact op de beslissingen die we nemen en de acties die we ondernemen.”

QU

Quentin

Effectual Impact

“Ons talent-acquisitionteam heeft waardevolle tijd bespaard door ATS-invoer te automatiseren en samenvattingen op maat te ontvangen. Nu kunnen we ons richten op wat echt telt: het beste talent vinden.”

PM

Pierre-Michel

CEO, Dream Catcher Sales

“100% van onze gesprekken wordt vastgelegd en geanalyseerd. Elke vergadering is eindelijk een waardevolle bron van data.”

FL

Francis Lelong

CEO, Alegria.group

Het soevereine alternatief

Gekozen door mensen van de beste organisaties wereldwijd

en duizenden andere teams in heel Europa.

Veelgestelde vragen

Vragen over de API

Authenticatie, paginering, wat de antwoorden bevatten en hoe het met webhooks staat.

Alle
Aan de slag
Wat je krijgt
Webhooks en abonnementen

Heb je nog een vraag? Praat met ons team

Hoe authenticeer ik me?

Met een API-sleutel in de X-API-Key-header van elk verzoek. De sleutel hoort bij je Noota-werkruimte en geeft toegang tot de opnames daarin. Bewaar hem op de server, nooit in een browser of mobiele app.

Open de API-documentatie

Waar staat de documentatie?

Op api.noota.io/docs: een Swagger UI waar je elk endpoint, de parameters en het antwoordschema kunt lezen en een aanroep met je sleutel kunt proberen. De OpenAPI 3.1-specificatie staat op api.noota.io/api/v1/openapi.json om een client in jouw taal te genereren.

Hoe werkt de paginering?

GET /api/v1/record geeft per aanroep tussen 1 en 25 opnames terug (limit, standaard 10) en een next_cursor als has_more true is. Geef die terug als cursor om de volgende pagina te krijgen. Filter op start_date en end_date (Unix-timestamps), op status of op het e-mailadres van de eigenaar.

Hoe ziet een transcript eruit?

Een array van regels, elk met speaker_id, speaker_name, start en end in seconden, en text. Het antwoord bevat ook de titel, de duur en de deelnemers met naam, e-mail en telefoon als die bekend zijn.

Kan ik het AI-rapport krijgen, niet alleen het transcript?

Ja. GET /api/v1/report/{id} geeft het rapport terug dat met het sjabloon van de vergadering is gemaakt, standaard in HTML of als platte tekst met format=plaintext, met titel, categorie, eigenaar, contacten en vergader-URL. Het audio- of videobestand is beschikbaar via een ondertekende URL die 24 uur geldig is.

Hebben jullie webhooks?

Vandaag is de eventgestuurde route de Zapier-trigger New Report: die gaat af zodra een vergaderrapport klaarstaat, met het transcript, de samenvatting, de scorekaart en de audiolink, en Zapier kan het naar elke URL van jou sturen of naar meer dan 5.000 apps. Native webhooks van Noota staan op de roadmap: vertel ons wat je ermee zou bouwen.

Noota op Zapier

Welke abonnementen bevatten de API?

API-toegang, Zapier, de Teams-app en de MCP-integratie zitten in de abonnementen Business en Enterprise. Enterprise voegt integraties op maat toe die we samen met je bouwen.

Bekijk de prijzen

Je volgende vergadering is waarschijnlijk vandaag

Laat het aan Noota over, die regelt de rest.