Skip to main content
POST
/
api
/
public
/
organizations
Create an organization
curl --request POST \
  --url https://charts.basedash.com/api/public/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "customAiContext": "<string>",
  "skipOnboarding": true,
  "fullEmbedEnabled": true,
  "embedAllowedOrigins": [
    "<string>"
  ],
  "slug": "<string>",
  "isBillable": true,
  "insightsEnabled": true
}
'
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "customAiContext": "<string>",
    "onboardingStatus": "STARTED",
    "fullEmbedEnabled": true,
    "embedAllowedOrigins": [
      "<string>"
    ],
    "isBillable": true,
    "insightsEnabled": true,
    "trialEndsAt": "<string>",
    "jwtSecret": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token format: Bearer <basedash_api_key>

Query Parameters

​
include
enum<string>

Include sensitive fields in the response. Use jwtSecret to include the embed JWT secret.

Available options:
jwtSecret

Body

application/json
​
name
string
required

Name of the organization

Minimum string length: 1
​
customAiContext
string

Custom context for AI features

​
skipOnboarding
boolean

Skip onboarding flow

​
fullEmbedEnabled
boolean

Enable full embed functionality

​
embedAllowedOrigins
string[]

Allowed origins for embedding. Supports exact URLs (https://example.com) and wildcard patterns (https://*.example.com)

​
slug
string

URL-friendly slug. If not provided, a unique slug will be generated.

​
isBillable
boolean

[Self-hosted] Controls whether the organization is billable. Defaults to true. Relevant for self-hosted deployments where billing gates certain features. When false, the organization will not be counted towards billable usage and will have a limited set of features. When true, the organization will be counted towards billable usage (after a 14-day trial) and will have access to all features.

​
insightsEnabled
boolean

Enable automated insights generation for this organization. Defaults to true.

Response

Organization created successfully. The jwtSecret field is only included when explicitly requested via ?include=jwtSecret.

​
data
object
required