Authentication

Security scheme type	HTTP
HTTP authorization scheme	Basic

Security scheme type

HTTP

HTTP authorization scheme

Basic

Credentials

Find your Group ID (username)

Your Operata Group ID is the UUID in the URL when you’re logged in to Operata.For example, if your URL is https://app.operata.io/a28453f9-abab-cdcd-efef-84d9e67ac297/dashboard, your Group ID is a28453f9-abab-cdcd-efef-84d9e67ac297.

Generate an API token (password)

Log in to the Operata console and go to Settings → Config → API to create a token. Treat tokens like passwords — store them securely and never commit them to version control.

Send the credentials in the Authorization header

Pass your Group ID and token using HTTP Basic auth. Most HTTP clients encode and attach the header automatically.

Example request

curl -u "<group-id>:<api-token>" \
  https://api.operata.io/v1/data/calls

const groupId = process.env.OPERATA_GROUP_ID;
const token = process.env.OPERATA_API_TOKEN;
const auth = Buffer.from(`${groupId}:${token}`).toString("base64");

const response = await fetch("https://api.operata.io/v1/data/calls", {
  headers: { Authorization: `Basic ${auth}` },
});

import os
import requests

response = requests.get(
    "https://api.operata.io/v1/data/calls",
    auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
)

See the Operata Help Centre article on API tokens for guidance on creating, viewing, changing, and revoking tokens.

Keep tokens secret. Store API tokens in environment variables or a secrets manager. Rotate them regularly in line with your organization’s security policy.

Overview & quickstart

API essentials

Endpoints — Contacts

Endpoints — Logs

Endpoints — Users

Endpoints — Data redaction

Events & webhooks

Streaming & backends

AI & MCP

Credentials

Example request

​Credentials

​Example request

Credentials

Example request