Skip to Content
API ReferenceAppsCreate App

Create App

Creates a new WhatsApp Business API (WABA) app under an existing user. The app name must be unique within the partner account.

Endpoint

POST /api/v1/partner/users/:user_id/apps

Path Parameters

ParameterTypeRequiredDescription
user_idUUIDYesThe user’s unique identifier

Request Body

FieldTypeRequiredDescription
namestringYesName for the app

Response

Success 201 Created

{ "success": true, "app_name": "My WhatsApp App", "app_id": "61f06252cf0a58553378ceb5", "created_at": "2026-02-14T08:15:00Z" }

Errors

StatusErrorDescription
400Invalid user IDuser_id is not a valid UUID
400Missing app_nameapp_name is required
401UnauthorizedInvalid or missing API key
404User not foundUser doesn’t exist under your account

Note: If an app with the same name already exists, a unique suffix will be appended automatically (e.g. My App 2).

Try It

POST/api/v1/partner/users/{user_id}/appsCreate an app
{user_id}