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
๐ Retrieve the messages of a conversation to feed your site planning
โ๏ธ 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 ๐ ๏ธ
Go to the Menu โ Settings of your workspace
Click the API Keys tab ๐
Click "Create an API key" โ
Give it a clear name (e.g. "Make - ERP" or "Zapier - Archiving") ๐
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 ๐ )
๐ Building an app where each user connects their own Kraaft account? The API also supports OAuth 2.0, in addition to API keys
๐ฆ What you can do with the Kraaft API today
The Kraaft API gives you access to 6 resources ๐๏ธ
๐๏ธ Workspaces โ list the workspaces accessible with your key
๐ Schemas โ read the structure of your reports to know what to send and receive
๐ Records โ list, read, create and update your reports
๐ฌ Conversations โ read, create, archive a conversation and manage its members
๐จ Messages โ send messages and files (photos, documents) into a conversation, and read the message history
โก Events โ detect in real time everything happening on your reports and messages
โก Zoom on Events
Kraaft keeps a log of everything that happens ๐ Every report created, updated, deleted or restored and every message sent, edited 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, or your planning picks up every new piece of info posted in a site conversation โก
๐ค Using the Kraaft API with an automation tool
Want to connect the Kraaft API to a no-code tool? Absolutely possible ๐
โ Make โ install the Kraaft app directly from make.kraaft.co: you connect via OAuth, in one click, no need to copy a key by hand
๐ง n8n, Zapier and others โ use your tool's HTTP or API request modules to call the Kraaft API with your key
๐ 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.
๐ Discover KDE
๐ง Want to use Kraaft from an AI assistant?
The API is built to connect tools together, automatically ๐ง To ask questions about your Kraaft data or request an action in plain language from Claude, ChatGPT or another AI assistant, use the Kraaft MCP instead ๐ค
๐ Want to go further?
Reading the messages of a conversation, API key or OAuth, key roles in detail, resolving IDs, lists and tables, filtering and real timeโฆ we've gathered every subtlety of the API in a companion article ๐ต๏ธ
๐ Need help?
If you have any questions, Contact us!
