Skip to main content

🔌 How to use the Kraaft API

Kraaft makes it easy to connect your workspace to your other tools and automate your workflows: no more double entry, just smart connections 💡

A few concrete examples ⬇️

  • 🏗️ Automatically create a Kraaft conversation from your ERP when a project kicks off

  • 📂 Archive your reports in SharePoint, Google Drive or your DMS as soon as they’re completed

  • 🔔 Trigger an action in an external tool as soon as a report’s status changes in Kraaft

  • 💬 Automatically send a message or photo in a conversation from a third-party tool


☑️ Step 1: Activate the API on your Kraaft workspace

The Kraaft API isn’t activated by default ⚙️ To get it, contact our support.

⚠️ Only an account owner can request activation.


🔑 Step 2: Create a Kraaft API key

Once the API is activated, the workspace admin or owner can create keys from the settings 🛠️

  1. Go to the Menu → Settings of your workspace

  2. Click the API Keys tab 🔑

  3. Click "Create an API key" ➕

  4. Give it a clear name (e.g. "Make - ERP" or "Zapier - Archiving") 📋

  5. Choose the key’s role

💡 An API key’s permissions follow the exact same roles as in Kraaft: External, Standard, Administrator and Owner 👤 Each role gives access to a different scope of your conversations and reports — we cover the details of each role in our article "Going further with the Kraaft API", to help you pick the right one for your use case.

⚠️ The key is only shown once — copy it right away! If you lose it, you’ll need to create a new one (takes 2 minutes, but better to avoid it 😅)


📦 What you can do with the Kraaft API today

The API is organized around 4 resources 🗂️

  • 🗂️ Workspaces — list the workspaces accessible with your key

  • 📋 Schemas — read the structure of your reports to know what to send and receive

  • 📝 Records & Conversations — list, read, create and update your reports and conversations

  • ⚡ Events — detect everything happening in Kraaft in real time

⚡ Zoom on Events

Kraaft keeps a log of everything that happens: every report created, updated or deleted generates an event 🔔 Two ways to consume them:

  • List of events — poll Kraaft at regular intervals ("what happened since last time?")

  • Real-time events — get events instantly, as soon as they happen ⚡

Example: your ERP gets notified automatically as soon as a report moves to "Done" status in Kraaft — no manual action needed ⚡

✅ And since recently, you can also send messages and files (photos, documents) directly into a conversation via the API — handy for notifying a field team or attaching a document from a third-party tool, without opening the app 📤


🤖 Using the Kraaft API with an automation tool

Want to connect the Kraaft API to a no-code tool? Absolutely possible 🎉

  • ✅ Make: native Kraaft connectors are available directly in Make

  • 🔧 n8n, Zapier and others: use your tool’s HTTP or API request modules to call the Kraaft API

  • 🔜 More native Kraaft connectors are coming to other tools soon


📖 Accessing the Kraaft API documentation

The official documentation is available here 👉 developers.kraaft.co

It covers every available endpoint, the expected data formats and the authentication methods 📚 A technical profile will get up to speed quickly!


📊 Want to analyze your Kraaft data?

Kraaft Data Exchange (KDE) is made for that 📊 Connect your data to Power BI, Tableau or Looker — and manage your projects from a single data visualization tool.


🔍 Want to go further?

Key roles in detail, resolving IDs, lists and tables, connecting to Make/n8n… we’ve gathered every subtlety we found while testing the API in depth, in a companion article 🕵️


💬 Need help?

Did this answer your question?