Create a new app

Creates a new app in your PubNub account. Apps are containers for keysets.

Header Parameters
PubNub-Version string — REQUIRED

Possible values: [2025-11-01]

Request Body — REQUIRED
name string — REQUIRED

A human-readable name for the app

Responses
201

Success

Schema — OPTIONAL
id string

Unique identifier for the app

name string

Human-readable name for the app

createdAt string — OPTIONAL

ISO 8601 timestamp of creation

updatedAt string — OPTIONAL

ISO 8601 timestamp of last update

400

Bad Request Error

Schema — OPTIONAL
statusCode number
error string

Possible values: [BadRequest]

message string[]
401

UnauthorizedError

Schema — OPTIONAL
statusCode number
error string

Possible values: [Unauthorized]

message string[]
403

ForbiddenError

Schema — OPTIONAL
undefined
404

NotFoundError

Schema — OPTIONAL
statusCode number
error string

Possible values: [NotFound]

message string[]
500

InternalErrorError

Schema — OPTIONAL
statusCode number
error string

Possible values: [InternalError]

message string[]
* required
PubNub-Version*
Type: string
Possible values: [2025-11-01]
* required
name*
Type: string
A human-readable name for the app
Example Request
{
  "name": "My New App"
}
id
Type: string
Unique identifier for the app
name
Type: string
Human-readable name for the app
createdAt
Type: string
ISO 8601 timestamp of creation
updatedAt
Type: string
ISO 8601 timestamp of last update
Example Response
{
  "id": "app_123456",
  "name": "My New App",
  "createdAt": "2025-10-27T12:00:00Z",
  "updatedAt": "2025-10-27T12:00:00Z"
}
statusCode
Type: number
error
Type: string
Enum (1 values)
View all values
"BadRequest"
message
Type: array
Array items:
items
Type: string
statusCode
Type: number
error
Type: string
Enum (1 values)
View all values
"Unauthorized"
message
Type: array
Array items:
items
Type: string
statusCode
Type: number
error
Type: string
Enum (1 values)
View all values
"NotFound"
message
Type: array
Array items:
items
Type: string
statusCode
Type: number
error
Type: string
Enum (1 values)
View all values
"InternalError"
message
Type: array
Array items:
items
Type: string