Create App

Create a WorkOS machine-to-machine app. The server generates the app name. If neither access nor the deprecated roles field is supplied, access defaults to all.read with unrestricted security-group access. The plaintext client secret is returned only in this response.

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

Creation input. access takes precedence when both access and the deprecated roles field are supplied.

string | null

Optional application description.

access
object
roles
object
deprecated

Legacy access input. Use access.

string | null
deprecated

Accepted for compatibility but ignored; the server generates the name.

string | null
deprecated

Accepted for compatibility but ignored; the tid header is authoritative.

owners
array of strings | null
deprecated

Accepted for compatibility but not persisted for WorkOS v4 apps.

owners
Responses

401

Missing, invalid, or unauthorized API key or access token

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