The Kraaft API lets you connect your Kraaft workspace to your other tools and automate your workflows: no more double data entry β just smart connections π‘!
π What is the Kraaft API?
The Kraaft API is a technical interface that lets your external tools communicate directly with Kraaft π‘ In practice, you can trigger actions automatically, with no manual input.
Here are some examples of what you can do:
ποΈ Automatically create a Kraaft conversation from your ERP when a project is launched
π Archive your reports to SharePoint, Google Drive or your DMS as soon as they're complete
π Trigger an action in an external tool as soon as a report changes status in Kraaft
βοΈ Step 1: Activate the API on your Kraaft workspace
The Kraaft API isn't enabled by default βοΈ To get access, contact our support team.
β οΈ Only an account owner can request activation.
π Step 2: Create a Kraaft API key
Once the API is activated, the administrator or owner of the workspace can create keys from the settings.
Go to the Menu β Settings of your workspace
Click on the API Keys tab π
Click "Create an API key" β
Give it a meaningful name (e.g. "Make - ERP" or "Zapier - Archiving") π
Choose the role for the key based on your use case
The available roles:
Role | Rights & access | When to use it? |
Standard | Access only to conversations the key has been manually added to | Targeted use on specific conversations |
Administrator & Owner | Full access to the workspace, creation and modification | Classic use for a global integration |
β οΈ The key is shown only once β copy it immediately! 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
The API is built 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
β‘ Spotlight on Events π
Kraaft keeps a log of everything that happens: every report created, updated or deleted generates an event π Two ways to consume them:
Event list β query Kraaft at regular intervals ("what happened since last time?")
Real-time events β receive events instantly as they happen β‘
π‘ Example: your ERP is automatically notified as soon as a report changes to "Done" status in Kraaft β with no manual action needed.
β What's not yet possible: sending messages or files via the Kraaft chat.
π€ 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
π§ Zapier, n8n and others: use the HTTP or API request modules in your tool to call the Kraaft API
π More native Kraaft connectors will be available in other tools in the future
π Access the Kraaft API documentation
The official documentation is available here π developers.kraaft.co/docs
It details all available endpoints, expected data formats and authentication methods π A technical profile will find their way around quickly!
π Want to analyse your Kraaft data?
The 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 visualisation tool.
π Discover KDE
