Skip to content

For developers

Build with BotHub.

A REST API to trigger automations from your system, a flow editor to build the robots and code blocks to reuse what is already done. Plus an interest list for those who want to publish what they build in the catalog.

REST API

Trigger automations from your system.

Your system calls the API, the robot does the job on the target site or system, and the result comes back to you.

  • Token authentication, with tokens created in the dashboard.
  • Each task's data goes as JSON in the request body.
  • The result arrives at your webhook, or you check the status using the task ID.

Processing is asynchronous: the time until the result varies with the volume of tasks and the target site or system.

Request
POST https://api.bothub.bot/api/v1/job
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "automation_id": 1234,
  "automation_data": { "order": "4812" },
  "webhook_url": "https://your-system.com/bothub/callback"
}
Response
{ "id": "task-id" }

# Check the status later
GET https://api.bothub.bot/api/v1/job/task-id

Flow editor

Build the robot from blocks.

In the editor you lay out the steps the robot follows on any site or system: open pages, fill in fields, click, read data, choose a path and repeat for each item in a list.

  • Run it in test mode before putting it to work.
  • Every change is kept in the version history.
  • Passwords come from the vault, never written into the flow.
  1. STEP 1 Open the supplier system
  2. STEP 2 Fill in the order with the data received
  3. DECISION Does the data match? no: takes another path
  4. yes STEP 3 Save the receipt and send a notice

Code blocks

Write it once, use it in many automations.

Logging in to a system, switching companies, downloading a file: turn the snippet into a block and reuse it. Fix the block once and every automation that uses it runs with the fix.

Automation 1

  • Log in to the system
  • Switch company

Automation 2

  • Log in to the system
  • Download the file

Automation 3

  • Log in to the system
  • Switch company
  • Download the file

Creator program

Built an automation other companies could use?

Join the creator program interest list. We will talk with you about publishing your automation in the BotHub catalog.

Step 1

You tell us what you built

In the chat, you show us the automation and who it is for.

Step 2

We take a look

Our team reviews the automation and talks with you about publishing it.

Step 3

We agree on the terms

The program rules are shared with those who join the list.

  • Published automations run only on BotHub robots, which protects your code.
  • Clients pay the regular table price.

Want to join? Create your account and tell us in the chat that you want to publish.

Documentation

The documentation lives in the dashboard.

Log in and open the API menu, under Documentation. There you will find the API reference, examples and where to create access tokens.

Log in to the dashboard

Implementers

Do you build automations for your clients?

Consultancies and developers who implement automations with BotHub have their own partnership track, with terms agreed in conversation.

See the implementer track

Create your account and make your first call today.

Try it free

No credit card to get started. 100 free runs to try it out.