Authentication in the Hablla API

Hablla’s 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 safely used in automated environments.

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

How to obtain it

You can obtain the workspace token by accessing https://studio.hablla.com/ as an administrator. After logging in, go to the settings menu through the gear icon in the top-right corner. The token will be displayed within the company information.

📌 Visual example:

Only the user with the Administrator role has access to this information. 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 a bot)	❌ No	✅ Yes