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
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
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