Create an App

Creates an app for the authenticated client and returns the id to send as the app-id header on every messaging request from then on.

Authenticates with api-token alone — do not send an app-id header. Requiring one here would be circular, since this endpoint is how an app-id comes to exist.

The name must be unique among your active apps, which is the only condition that answers 409. There is no cap on how many apps a client may hold.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Create an app with POST /v1/apps by sending a unique name and the api-token header. Do not send an app-id header: the response returns the app's id, which you use as app-id on subsequent messaging requests.

Body Params
string
required
length between 1 and 255

App name. Trimmed, and unique among your active apps. The identifier is minted by LigueLead and cannot be chosen.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json