Authentication in the Hablla API

The Hablla API uses authentication via Workspace Token, a recommended approach for integrations, automations, and bots.

Authentication via Workspace Token (Recommended)

The Workspace Token is a token directly linked to a specific workspace. It is the most practical and robust form of authentication for integrations and automations.

Main Advantages:

• Allows access to most API routes.

• Does not expire.

• Can be used safely in automated environments.

• Offers traceability (actions are recorded in the history as executed via automation).

How to get it

You can capture the workspace token when running a flow in Hablla that uses an API component. In the request response, it will be available in the header Authorization.

📌 Visual example:

The field Authorization contains the token you should use. Important: always replace it with token_here when sharing public examples to avoid leaks.

Identifying the Workspace ID

The workspace ID (example: 64e683e59a0a699241b5222c) is unique per customer. You can find it directly in the browser URL when accessing your environment in Hablla Studio:

https://studio.hablla.com/workspaces/<WORKSPACE_ID>

Request example

curl "https://api.hablla.com/v2/workspaces/<WORKSPACE_ID>/persons?page=1&limit=50" \
  -H "authorization: <YOUR_TOKEN_HERE>" \
  -H "accept: application/json"

Conclusion

Token Type	Ideal for	Traceable actions?	Expiration	Recommended?
Workspace Token	Integrations, automations, bots	✅ Yes (as bot)	❌ No	✅ Yes