Skip to main content
POST
Create a new Data App in your organization. Data Apps serve as containers for organizing embed configurations, API tokens, and access controls for your embedded analytics.
Data Apps are the top-level organizational unit for embedded analytics. Each Data App can contain multiple embed configurations and has its own set of API tokens for authentication.
Authentication Requirement: This endpoint requires a service token (not a data app API key). Service tokens have elevated permissions to manage Data Apps across your organization.

Endpoint Formats

Authentication

This endpoint requires a service token in the Authorization header. Service tokens differ from data app API keys and provide organization-level permissions. To access your service token:
  1. In Settings page, navigate to the Service Tokens section.
  2. Click the “Generate Token” button to create a new service token if you don’t have one already.
Use this token as the Bearer value in your Authorization header.

Headers

string
required
Bearer token for API authentication. Use your service token (not data app API key).
string
required
Must be set to application/json for all requests.

Request Body

string
required
The unique name for the Data App. This name must be unique within your organization.

Response

string
The name of the newly created Data App.
object
Error object returned only when the request fails. Not included in successful responses.

Examples

HTTP Status Code Summary

Possible Errors

Quick Start Guide

1

Get your service token

In Settings page, navigate to the Service Tokens section. Click the “Generate Token” button to create a new service token if you don’t have one already.
2

Create the Data App

Make a POST request with a unique name for your Data App:
3

Create an API token for the Data App

After creating the Data App, create an API token to use for embed operations. See the Create API Token endpoint.
4

Create embed configurations

Use the API token to create embed configurations for your dashboards and metrics.

Next Steps

List Data Apps

View all Data Apps in your organization

Create API Token

Generate API tokens for your Data App

Create Embed

Create embed configurations for dashboards

Delete Data App

Remove Data Apps you no longer need