organisatiesMijn organisatiesDe Boldcaster-organisaties waar deze gebruiker bij hoort en waar de AI-koppeling aanstaat, met zijn rol en welke onderdelen vrijgegeven zijn. Roep dit eerst aan: elke andere tool vraagt een org_id.
Everything Boldcaster offers to the outside world is on this page. The list below comes straight from the connection itself, so it never lags behind what is actually running.
There are two doors to the same data: the AI connection for an assistant, and the REST API for everything else. Each has its own switch, because permission for one is not permission for the other. Beyond that the same three conditions apply to both, and when something fails the answer says which of the three it was.
Every call is written to the organisation's log, including refused ones. That is deliberate: a connection that reads along should be visible to whoever switched it on.
Claude, ChatGPT and Vibe speak this protocol. Add the address as a connector and sign in with your Boldcaster account.
https://boldcaster.com/mcp
Step by step per app is on the AI connection page.
For anything that isn't an AI assistant: Power BI, a script, or your client's data warehouse. The same data and the same rights as above, in plain JSON.
https://boldcaster.com/api/v1
An owner creates a key under Integrations, at API keys. It goes in the Authorization header; a key is valid for one organisation.
curl -H "Authorization: Bearer bc_live_..." \ "https://boldcaster.com/api/v1/team?org_id=..."
Request the address above without a key and you get the list of endpoints back, with their parameters.
To check a key, make one call: 200 with a valid key, 401 without. This is also the address Zapier and Make use to verify a key someone entered. https://boldcaster.com/api/v1/wie-ben-ik
With a webhook, Boldcaster sends a message to your address as soon as something happens. The owner of the organisation creates it in the app, under Integrations at Webhooks. You do not need an API key for it. These are the events:
taak.aangemaakt A task is added under a priority, in a project or as a loose task.taak.gewijzigd The title, deadline, owner or status of a task changes, or a completed task is reopened.taak.klaar Someone ticks off a task.prioriteit.aangemaakt A rock or OKR is added.prioriteit.afgerond A rock or OKR is completed.kpi.rood A measurement comes out red against the quarterly target.reflectie.ingediend Someone submits a monthly, quarterly or annual reflection. Only who and which period, not the content.Every message is a POST with JSON. The header says which event it is, the content sits under gegevens.
POST https://jouw-adres.example/boldcaster
X-Boldcaster-Event: taak.klaar
X-Boldcaster-Delivery: 5f0c2a1e-...
X-Boldcaster-Signature: t=1791629208,v1=9b2f...
{
"id": "2b41810e-...",
"gebeurtenis": "taak.klaar",
"tijdstip": "2026-10-10T11:41:26Z",
"organisatie_id": "...",
"gegevens": {
"taak": { "id": "...", "nummer": 156, "titel": "Offerte versturen",
"klaar": true, "status": "open", "deadline": null, "eigenaar_id": "..." },
"onderdeel": { "id": "...", "titel": "Nieuwe klanten Q4", "soort": "prioriteit" }
}
}Verify the signature before you act on a message. It is an HMAC-SHA256 over the timestamp, a full stop and the raw body, using the signing secret you received when you created the webhook.
import { createHmac, timingSafeEqual } from "node:crypto";
// body: de ruwe tekst van het bericht, niet de geparste JSON
function echt(body, header, geheim) {
const { t, v1 } = Object.fromEntries(header.split(",").map((d) => d.split("=")));
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const verwacht = createHmac("sha256", geheim).update(t + "." + body).digest("hex");
return v1.length === verwacht.length && timingSafeEqual(Buffer.from(v1), Buffer.from(verwacht));
}Respond with a 2xx within ten seconds. If that fails we retry after 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours. A message can therefore arrive twice: use the id to recognise duplicates. After fifteen failed messages in a row we switch the webhook off and the owner gets a notification.
Tasks from a private project are not sent, and neither are descriptions, notes or the content of a reflection. Fetch anything else you need through the REST API. The address must be https, use a domain name and must not redirect.
These change nothing. They return the same figures and traffic lights as the screens in Boldcaster, computed by the same code.
organisatiesMijn organisatiesDe Boldcaster-organisaties waar deze gebruiker bij hoort en waar de AI-koppeling aanstaat, met zijn rol en welke onderdelen vrijgegeven zijn. Roep dit eerst aan: elke andere tool vraagt een org_id.
teamTeamHet team van een organisatie zoals het teamoverzicht in Boldcaster het toont: naam, rol (de rechten in Boldcaster), functietitel en user_id, en per bedrijfsproces wie eindverantwoordelijk is en welke rollen eronder vallen (Team > Teamleden, weergave Functies). Een rol is een plek met een eigen naam: er zit iemand op, of hij is open (`wie` is dan null, en hij staat ook in `open_rollen`). `zonder_rol` zijn de teamleden die geen proces leiden en op geen enkele rol zitten. Gebruik de user_id om eigenaren van prioriteiten, KPI's en taken te koppelen.
/api/v1/teamorg_iduuidrequiredprioriteitenPrioriteitenDe prioriteiten (rocks en OKR's) van een kwartaal, zoals het Prioriteiten-scherm ze toont: titel, soort, eigenaar, voortgang, stand en deadline. Rocks en OKR's staan door elkaar; `soort` zegt welke het is. De stand volgt de kaart in Boldcaster en legt de voortgang naast de verstreken looptijd (startdatum tot deadline, anders het kwartaal): 'op koers' als de voortgang de tijd bijhoudt, 'aandacht nodig' vanaf 80% daarvan, 'loopt achter' daaronder, 'nog niet gestart' als de prioriteit nog moet beginnen, 'geen taken' als er niets is om op te meten. Zet alleen_aandacht aan voor de vraag welke prioriteiten achterlopen.
/api/v1/prioriteitenorg_iduuidrequiredkwartaalstringoptionalalleen_aandachtja/neeoptionalkpi_scorebordKPI-scorebordHet KPI-scorebord van een kwartaal, uitgerekend door dezelfde code als het scherm in Boldcaster: per KPI het kwartaaldoel, de huidige stand, het stoplicht en de eigenaar. Een KPI wordt per week óf per maand gemeten (`cadans`); cumulatieve KPI's worden pro rata naast het doel gelegd. Groen is op of boven de lijn, oranje vanaf 80%, rood daaronder. Reken zelf niets opnieuw uit: dit is wat de klant op zijn scherm ziet.
/api/v1/kpi-scorebordorg_iduuidrequiredkwartaalstringoptionalweektakenWeektakenDe taken op het weekbord van een organisatie voor één ISO-week, per persoon: titel, status, of hij klaar is, en de prioriteit (rock_id) waar hij bij hoort. Handig voor vragen als 'wat staat er deze week open bij Mark?'.
/api/v1/weektakenorg_iduuidrequiredweekstringoptionalwaarderingBedrijfswaarderingDe vastgelegde bedrijfswaarderingen van een organisatie, nieuwste eerst: per meting de periode, de omzet, de genormaliseerde EBITDA, de multiple en de aandelenwaarde. Dit is de historie zoals opgeslagen op het moment van meten; reken niets opnieuw uit. Let op: het bedrag op het waarderingsscherm kan hoger of lager liggen dan de laatste meting hier, want dat scherm rekent live met de huidige formule en slaat pas op als de ondernemer bewaart. Noem dat verschil als het ter sprake komt in plaats van één van de twee als de waarheid te presenteren. Metingen zonder cijfers (een openstaande uitnodiging aan de boekhouder) blijven eruit. Bevat geen facturen of grootboekregels: Boldcaster bewaart alleen samengestelde cijfers.
/api/v1/waarderingorg_iduuidrequiredaantalgeheel getaloptionalgesprekkenFunctioneringsgesprekkenDe functioneringsgesprekken van een organisatie: per gesprek wie, met wie, welke soort, de datum, of het is afgerond en de eindclassificatie (A tot en met D). Bevat bewust geen salarisgegevens en geen vrije tekst uit het gesprek zelf; wie de inhoud nodig heeft opent het gesprek in Boldcaster. Je ziet alleen de gesprekken die je in Boldcaster ook zou zien: met toegang tot Team het hele team, anders je eigen gesprekken en die waarin je zelf de gespreksleider bent.
/api/v1/gesprekkenorg_iduuidrequiredjaargeheel getaloptionalalleen_openja/neeoptionalsessienotitiesSessienotitiesDe notities van sessies met de coach of het MT: per sessie de datum, het soort sessie, de samenvatting, highlights, besluiten, learnings en de actiepunten met eigenaar en deadline. Gebruik dit om een volgende sessie voor te bereiden of na te gaan wat er is afgesproken. Een notitie met status 'concept' is nog niet nagelezen en alleen zichtbaar voor de coach.
/api/v1/sessienotitiesorg_iduuidrequiredaantalgeheel getaloptionaltakenTakenDe taken van een organisatie: onder een prioriteit (rock of OKR), in een project, en de losse taken. Per taak het nummer, de omschrijving, waar hij bij hoort, de eigenaar, de stand, de deadline, de urgentie, labels, de inschatting in uren, de bestede uren en of hij herhaalt. Standaard alleen wat nog open staat. Filter op soort, op één prioriteit of project, of op eigenaar, of vraag één taak op met zijn nummer. De stand is die van het taakvenster in Boldcaster: open, bezig, wacht op feedback, klaar of vervallen. Vervallen is afgesloten zonder gedaan te zijn. Er komen hoogstens 200 taken terug; staat 'afgekapt' op true, filter dan verder.
/api/v1/takenorg_iduuidrequiredsoortkeuzeoptionalhoort_bij_iduuidoptionaleigenaar_user_iduuidoptionalook_afgeslotenja/neeoptionalnummergeheel getaloptionalprojectenProjectenDe lopende projecten van een organisatie: titel, eigenaar, looptijd, of het besloten is (alleen zichtbaar voor wie eraan meewerkt) hoeveel taken er open staan en hoeveel uur eraan is besteed. Een project is werk met een begin en een eind dat geen kwartaalprioriteit is. De taken zelf haal je op met `taken` en de id van het project. Je ziet alleen de projecten die je in Boldcaster ook ziet.
/api/v1/projectenorg_iduuidrequiredreflectiesReflectiesDe maand- of kwartaalreflecties van een organisatie voor één periode: per persoon wat goed ging, wat beter kan, wat hij leerde, de focus voor de volgende periode en het energieniveau. Je ziet wat je in Boldcaster ook ziet: je eigen reflectie altijd, die van je team pas als iedereen heeft ingediend en jij ook. Staat `team_zichtbaar` op false, zeg dan dat de ronde nog niet open is en raad niet wat collega's schreven. Zonder periode komt de laatste periode terug waarin iets is ingevuld.
/api/v1/reflectiesorg_iduuidrequiredsoortkeuzerequiredperiodestringoptionalurenBestede urenDe bestede uren van een organisatie over een periode: per persoon hoeveel uur, en waaraan (per prioriteit, project of de losse taken). Dezelfde cijfers als het urenoverzicht in Boldcaster. Geef `van` en `tot` mee als JJJJ-MM-DD, beide dagen tellen mee. Zonder periode komt de lopende maand terug. Voor een maand: de eerste en de laatste dag van die maand. Wie niet alle uren mag zien, krijgt alleen zijn eigen uren terug; het antwoord zegt dat erbij. Uren per losse taak, zonder periode, staan in `taken`.
/api/v1/urenorg_iduuidrequiredvanstringoptionaltotstringoptionaluser_iduuidoptionalThese do write. They only work when the organisation is not set to read only, and should run after an explicit yes from the user.
prioriteit_aanmakenPrioriteit aanmakenMaakt één prioriteit (rock of OKR) aan in Boldcaster, net als de knop op het Prioriteiten-scherm. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met titel, soort, eigenaar, kwartaal en een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Maak er nooit meerdere aan op eigen initiatief. Een goede rock is één uitkomst die aan het eind van het kwartaal af is, meetbaar, met precies één eigenaar. Geen doorlopende taak, geen wens. Hooguit drie tot vijf per persoon per kwartaal; heeft iemand er al zoveel, zeg dat dan eerst. Rock of OKR kies je expliciet (`soort`); ze staan in dezelfde lijst. Een OKR krijgt hier nog geen key results; die voegt de gebruiker in Boldcaster toe. De eigenaar is een user_id uit de tool `team`.
/api/v1/prioriteit-aanmakenorg_iduuidrequiredtitelstringrequiredsoortkeuzerequiredeigenaar_user_iduuidrequiredkwartaalstringoptionaldeadlinestringoptionalomschrijvingstringoptionalbevestigcodestringoptionalkpi_meting_invoerenKPI-meting invoerenZet één meting op een KPI in Boldcaster, net als het invoerveld op het KPI-scorebord. Overschrijft een eerdere meting in dezelfde periode. Een KPI wordt per week óf per maand gemeten; de periode moet in die cadans ("2026-W40" of "2026-09"). Leeg is de lopende week of maand. Vraag de KPI's en hun cadans eerst op met `kpi_scorebord`. Komt de KPI op oranje of rood, dan eist Boldcaster een toelichting. Vraag de gebruiker daar dan om in plaats van er zelf een te verzinnen. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel (met de waarde die er nu staat, als die er is) en een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code.
/api/v1/kpi-meting-invoerenorg_iduuidrequiredkpi_iduuidrequiredwaardegetalrequiredperiodestringoptionaltoelichtingstringoptionalbevestigcodestringoptionaltaak_toevoegenTaak toevoegenZet één taak in Boldcaster: onder een bestaande prioriteit (rock of OKR), in een bestaand project, of als losse taak die nergens bij hoort. Geef `prioriteit_id` of `project_id` mee; zonder een van beide wordt het een losse taak. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Zoek de prioriteit eerst op met `prioriteiten`, het project met `projecten` en de eigenaar met `team`. Een taak is één concrete stap met één eigenaar, geen nieuwe prioriteit. Zet een taak niet onder een prioriteit waar hij niet aan bijdraagt; dan is hij los. Een subtaak maak je met `onder_taak_nummer`: het nummer van de taak waar hij onder komt, uit `taken`. Hij hoort dan vanzelf bij dezelfde prioriteit of hetzelfde project; geef die niet mee. Subtaken gaan één laag diep en herhalen niet. Zonder eigenaar krijgt een subtaak de eigenaar van zijn taak.
/api/v1/taak-toevoegenorg_iduuidrequiredprioriteit_iduuidoptionalproject_iduuidoptionalonder_taak_nummergeheel getaloptionalomschrijvingstringrequiredeigenaar_user_iduuidoptionaldeadlinestringoptionalherhalenkeuzeoptionalgroottekeuzeoptionalinschatting_urengetaloptionalbevestigcodestringoptionalkpi_aanmakenKPI aanmakenZet één nieuwe KPI op het KPI-scorebord in Boldcaster. Het doel en het proces stelt de gebruiker daarna in de app in. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Kijk eerst met `kpi_scorebord` of de KPI er niet al staat. Een KPI meet een uitkomst of een stuurgetal dat je elke week of maand invult, geen eenmalig project (dat is een prioriteit). Meetsoort "teller" telt op binnen het kwartaal (aantal leads, omzet); "stand" is een momentopname (aantal klanten, marge in %).
/api/v1/kpi-aanmakenorg_iduuidrequirednaamstringrequiredeenheidstringoptionaleigenaar_user_iduuidrequiredmeetsoortkeuzerequiredcadanskeuzerequiredlager_is_beterja/neeoptionalbevestigcodestringoptionalstrategie_bijwerkenStrategie: wijziging voorstellenZet een voorstel klaar om een of meer tekstvelden van het strategiecanvas in Boldcaster te wijzigen: bhag (BHAG), purpose (Purpose), dna (DNA), jaarthema (Jaarthema), core_customer (Kernklant), core_competence (Kerncompetentie), brand_promise (Merkbelofte), sandbox_geo (Sandbox: regio), sandbox_niche (Sandbox: doelgroep), sandbox_product (Sandbox: product), profit_per_x (Winst per X), profit_per_x_toelichting (Winst per X: toelichting). Deze tool wijzigt zelf niets. Het voorstel komt in Boldcaster te staan, met per veld wat er nu staat en wat het wordt, en een eigenaar, admin of MT-lid keurt het daar goed of af op de strategiepagina. Zeg dat ook tegen de gebruiker. Laat de gebruiker eerst zien wat je gaat voorstellen. Een veld dat je niet meegeeft blijft zoals het is. Stel alleen voor wat de gebruiker in het gesprek echt heeft besloten, in zijn eigen woorden, en vul niets aan wat niet gezegd is. Alleen een eigenaar, admin of MT-lid kan een wijziging in de strategie voorstellen; bij een ander weigert Boldcaster.
/api/v1/strategie-bijwerkenorg_iduuidrequiredveldenobjectrequiredweektaak_toevoegenWeektaak toevoegenZet één taak op het weekbord in Boldcaster, in de kolom voor nieuw werk. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Zonder `voor_user_id` is de taak van de gebruiker zelf. Een taak voor een collega kan alleen een eigenaar, admin of MT-lid zetten. Hoort de taak bij een prioriteit, geef dan `prioriteit_id` mee (uit `prioriteiten`).
/api/v1/weektaak-toevoegenorg_iduuidrequiredtitelstringrequiredweekstringoptionalvoor_user_iduuidoptionalprioriteit_iduuidoptionalbevestigcodestringoptionaldagprioriteiten_zettenDagprioriteiten zettenZet de drie prioriteiten van de dag voor de gebruiker zelf in Boldcaster, zoals op het scherm Dagplanning. Alleen voor jezelf, nooit voor een collega. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel waarin staat wat er nu staat en wat het wordt, met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Een prioriteit die je niet meegeeft blijft zoals hij is. Hooguit drie: wie er meer noemt, vraag welke drie vandaag echt moeten.
/api/v1/dagprioriteiten-zettenorg_iduuidrequireddatumstringoptionalprioriteit_1stringoptionalprioriteit_2stringoptionalprioriteit_3stringoptionalbevestigcodestringoptionalsessienotitie_schrijvenSessienotitie schrijvenLegt een sessienotitie vast als concept: de coach leest hem na in Boldcaster en stelt hem vast, pas dan ziet de klant hem. Gebruik alleen wat in de sessie is gezegd en besloten. Verzin geen eigenaren of deadlines bij actiepunten; laat ze leeg als ze niet zijn genoemd. Werkt in twee stappen: de eerste aanroep geeft een voorstel met een bevestigcode, de tweede (na een ja van de gebruiker, met dezelfde invoer en de code) schrijft.
/api/v1/sessienotitie-schrijvenorg_iduuidrequireddatumstringrequiredtitelstringrequiredsoortkeuzerequiredsamenvattingstringrequiredhighlightsarrayoptionalbesluitenarrayoptionallearningsarrayoptionalactiepuntenarrayoptionalbevestigcodestringoptionaltaak_bijwerkenTaak bijwerkenWerk één bestaande taak bij in Boldcaster: de stand (open, in_uitvoering, wacht_op_feedback, voltooid of vervallen), de eigenaar, de deadline, herhalen, de grootte of de omschrijving. Geef alleen mee wat moet veranderen. Vervallen is afsluiten zonder dat het gedaan is: de taak staat nergens meer open en telt niet mee in de voortgang. Gebruik voltooid alleen als het werk echt af is. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode, met per veld wat er nu staat en wat het wordt. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Zoek de taak eerst op met `taken`. Verwijderen kan niet via de koppeling.
/api/v1/taak-bijwerkenorg_iduuidrequiredtaak_iduuidrequiredstandkeuzeoptionaleigenaar_user_idtekstoptionaldeadlinetekstoptionalherhalenkeuzeoptionalomschrijvingstringoptionalgroottekeuzeoptionalinschatting_urentekstoptionalbevestigcodestringoptionalproject_aanmakenProject aanmakenMaakt één project aan in Boldcaster. Een project is werk met een begin en een eind dat geen kwartaalprioriteit is; het staat los van de rocks en OKR's en hoort niet bij een kwartaal. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Kijk eerst met `projecten` of het project er al staat. Is het één uitkomst die dit kwartaal af moet en waar het bedrijf op stuurt, dan is het een prioriteit (`prioriteit_aanmaken`); is het één handeling, dan is het een taak (`taak_toevoegen`). Het project is zichtbaar voor het hele team; besloten maken doet de gebruiker in Boldcaster.
/api/v1/project-aanmakenorg_iduuidrequiredtitelstringrequiredeigenaar_user_iduuidrequireddeadlinestringoptionalomschrijvingstringoptionalbevestigcodestringoptionalEvery answer that isn't a 200 contains a `fout` with one of these codes, plus a message in plain language. The code is stable; build against that, not against the text.
| 401 | geen_sleutel | No key sent, or it doesn't look like one of ours. |
| 401 | sleutel_ingetrokken | The key existed but has been revoked in Boldcaster. |
| 403 | verkeerde_organisatie | The org_id differs from the one this key was created for. |
| 403 | koppeling_uit | The switch for this door is off for that organisation. |
| 403 | onderdeel_uit | This section has not been released. An owner ticks it. |
| 403 | rol_mag_niet | Your role in that organisation may not see this section, or the module is off. |
| 403 | alleen_lezen | The connection is read only, and this endpoint writes. |
| 400 | ongeldige_parameters | A parameter is missing, has the wrong shape, or doesn't exist. The message says which. |
| 404 | onbekend_endpoint | That address doesn't exist. Request the index for the list. |
Looking for data that isn't in here, or want to connect a system we don't support yet? Let us know. We build on what people actually use.
Send us a message →