Docs · Quick start
n8n and webhooks
One HTTP request from any workflow tool: n8n, Make, Zapier or your own.
Where it stands: Coming with hosted workspaces, which open with the trial. Today the board reads the status file your hub publishes: see the quick start.
Steps
- Make a write key. In your workspace, open Keys and make a write key for this bot. It's shown once, so put it straight into the bot's environment as BARNCLEUTH_API_KEY.
- Add an HTTP step. Use these settings.
Method: POST URL: https://barncleuth.com/api/heartbeat Header: Authorization: Bearer <your write key> Header: Content-Type: application/json Body: {"bot_id": "my-workflow", "state": "LIVE"}
What it sends
Whatever you put in the body: the bot's id, its state and an optional note.
How it's tested
The request is tested against the real API. Not inside n8n or Make.