Menu

Samenvatting van de Basecamp API

De Basecamp API laat je projectmanagement en teamcommunicatie automatiseren. Elk tool dat in de UI zichtbaar is — projecten, todo lists, message boards, schedules, vaults, card tables en Campfire-chats — is via de REST API te benaderen, inclusief het project-dock dat aangeeft welke tools per project actief zijn.
  • Projecten en templates: Maak projecten aan vanuit templates, beheer dock-tools per project en synchroniseer projecttoegang met je HR- of SSO-systeem.
  • Todo's en card tables: Lees, maak en update todo lists, todo's, hill chart-data en kanban-kaarten met kolommen, on-hold-status en stappen.
  • Berichten en Campfire: Plaats berichten op message boards, post lines in Campfire-chats via chatbots en pin belangrijke berichten vast.
  • Documenten en uploads: Beheer vaults met documenten en bestanden inclusief versies, en gebruik attachments voor inline rich-text-content.
  • Planningen, uren en webhooks: Schrijf schedule-entries en timesheet-entries, ontvang events per project via webhooks en gebruik de client-portal endpoints voor goedkeuringen en correspondentie.
API Quick Facts REST
  • Authenticatie OAuth2, Bearer Token
  • Methods POST (41)DELETE (20)GET (100)PUT (42)
  • Rate limits Dynamische limieten; richtwaarde 50 requests per 10 seconden per IP-adres, met aparte buckets voor GET/POST en per-uur/dag — gebruik de Retry-After-header
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering URL-based
  • SDK's Ruby, Node.js, Python

Laatste ontwikkelingen bij de Basecamp API

Met Basecamp 3 introduceerde 37signals in 2016 een volledig nieuwe REST API onder host 3.basecampapi.com, die niet backward-compatible is met de Basecamp Classic en Basecamp 2 API's. Authenticatie verloopt sindsdien uitsluitend via OAuth 2.0; basic auth en API-tokens werden afgeschaft. In 2018 kwamen webhooks erbij, in 2020 card tables en chatbot-integraties voor Campfire. In 2025 publiceerde Basecamp een officiële OpenAPI-spec plus een SDK-repo en introduceerde flat routes die de oudere /buckets/{project_id}/-vorm vervangen voor nieuwe integraties.

API versies

OpenAPI-spec & flat routes Major release
1 september 2025

Publieke OpenAPI 3.0-spec en officiële Basecamp SDK gepubliceerd; flat routes (zonder /buckets/{project_id}/-prefix) zijn nu de canonieke vorm voor alle nieuwe integraties.

Card tables & chatbots Major release
1 juni 2020

Card table-endpoints (cards, columns, steps, moves) en Campfire-chatbot-integraties toegevoegd.

Webhooks Major release
1 april 2018

Webhooks per project (bucket) toegevoegd voor realtime notificaties bij events op recordings.

Basecamp 3 REST API Major release
1 november 2016

Lancering van de Basecamp 3 REST API onder host 3.basecampapi.com; OAuth 2.0 verplicht, niet backward-compatible met Basecamp Classic of Basecamp 2.