Login•Plan demo
DataTako API

Automate your entire portal

The DataTako API lets your systems do what your admins do in the portal: create organisations, invite users, set up reports and manage access. Connect it to your CRM, onboarding flow or data pipeline.

Open the API referenceRead the docs
Available on Scale and Enterprise.
Create a client organisation
curl -X POST https://connect.datatako.com/api/v1/Organisation \
  -H "Authorization: $DATATAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Retail",
    "admins": [
      { "email": "jane@acme.example",
        "firstName": "Jane", "lastName": "Doe" }
    ]
  }'
Response
{
  "succeeded": true,
  "data": {
    "id": "7f3c9a2e-…",
    "name": "Acme Retail",
    "admins": [ { "email": "jane@acme.example", … } ]
  }
}
What you can automate

Everything you set up in the portal, in code

44 operations, documented in an OpenAPI reference at connect.datatako.com/swagger.

OR

Organisations

Create and update sub-organisations, with their admins and Power BI access.

US

Users

Create, update and remove users, and see what each user can open.

UG

User groups

Manage groups and their members.

RG

Report groups

Create, order and remove report groups.

RC

Report configurations

Add reports, or copy the set-up of an existing one, and get the report URL back.

AC

Access

Give users and groups access to reports, with their RLS roles.

PB

Power BI lookups

List workspaces, reports, semantic models, pages and RLS roles.

RF

Refresh

Trigger a dataset refresh after your pipeline finishes.

HT

HTML dashboards

Push a new version of an HTML dashboard from your own pipeline.

LG

Activity & logs

Pull report activity and your API request log.

Use cases

What teams build with the API

Onboard a new client in one script

Create the sub-organisation with its admin, add users and groups, copy your standard report set-up and give everyone access. What used to be an afternoon of clicking becomes one step in your onboarding flow.

Read more about sub-organisations →
POST/api/v1/Organisation
PUT/api/v1/User
POST/api/v1/ReportConfiguration
POST/api/v1/ReportConfiguration/{id}/user-groups

Keep users in sync

Create, update and remove users from your CRM or HR system, and keep group membership aligned, without anyone in DataTako lifting a finger.

Fresh data from your pipeline

Trigger a dataset refresh the moment your data load finishes, and push new versions of HTML dashboards straight from your build.

Know what's being used

Pull report activity into your own warehouse or BI, and audit every API call with the request log.

For developers

Built for developers

KY

API keys

Create keys in Settings → API keys. One header, no OAuth dance.

SO

Sub-organisations

Act inside any direct sub-organisation with the X-Organisation-Id header.

ER

Clear errors

Machine-readable error codes, such as users_not_found.

OA

OpenAPI

Full reference and schema at connect.datatako.com/swagger.

RL

Rate limits

240 requests per minute per key.

LG

Request log

Every call logged and available through the API.

AI apps

Prefer to work in a chat?

The API is for your systems. AI apps are for people: connect Claude or ChatGPT and work with your models and forms in plain language.

Explore AI apps →
FAQ

Questions about the API

How do I authenticate?

Create an API key under Settings → API keys and send it in the Authorization header.

Can I work in sub-organisations?

Yes. Keys with “Include sub-organisations” can act inside any direct sub-organisation by sending its id in the X-Organisation-Id header.

Is there a rate limit?

240 requests per minute per API key.

Which plan do I need?

The DataTako API is available on Scale and Enterprise.

Can I create data dashboards through the API?

No. Data dashboards are built through AI apps. The API can push new versions of HTML dashboards.

Start automating your portal

Available on Scale and Enterprise. We're happy to help you plan your first integration.

Book a demoOpen the API reference