Management API

Create App

POST/v1/app

Programmatically create a new App within a Meebly organization. An App is the top-level container for environments, agents, and actions.

Creating an App also creates the initial environments you specify in the request. Each environment gets its own API key and backend URL configuration.

Definition

Headers

bash

X-Access-Token: YOUR_ACCESS_TOKEN

Body Parameters

Parameter	Type	Required	Description
`organizationId`	string	Yes	The ID of the organization to create the app under. Must match the access token's organization.
`name`	string	Yes	Display name for the app
`environments`	object[]	Yes	At least one environment to create with the app. Each entry requires `name` (string) and `backendUrl` (valid URL).

Response

Returns 201 Created with the newly created app object, including the generated environment IDs and API keys.

json

{
  "id": "app_def456",
  "name": "Acme Corp",
  "organizationId": "org_abc123",
  "environments": [
    {
      "id": "env_prod111",
      "name": "Production",
      "backendUrl": "https://api.acmecorp.com",
      "apiKey": "mk_prod_..."
    },
    {
      "id": "env_stg222",
      "name": "Staging",
      "backendUrl": "https://staging-api.acmecorp.com",
      "apiKey": "mk_stg_..."
    }
  ],
  "createdAt": "2025-01-15T12:00:00Z"
}

Store the environment id and apiKey values returned in the response — you will need them to create agents and actions inside this app, and to authenticate chat and execute requests.

Sample Request

bash

curl -X POST "https://api.meebly.ai/v1/app" \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: YOUR_ACCESS_TOKEN" \
  -d '{
    "organizationId": "org_abc123",
    "name": "Acme Corp",
    "environments": [
      {
        "name": "Production",
        "backendUrl": "https://api.acmecorp.com"
      },
      {
        "name": "Staging",
        "backendUrl": "https://staging-api.acmecorp.com"
      }
    ]
  }'

PreviousResponse Extraction NextCreate Action

Last updated: March 2026Report an issue