Create an OAuth client

Creates an OAuth Client, which can be used to allow users (using their Linode account) to log in to your own application, and optionally grant your application some amount of access to their Linodes or other entities.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • Identity and access permissions. Your user needs a role with these permissions. Learn more.

    • Permissions: create_oauth_client
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: account:read_write

CLI

linode-cli account client-create \
  --label Test_Client_1 \
  --redirect_uri https://example.org/callback

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
Body Params

A third-party application registered to Linode that users may log into with their Linode account through our authentication server at login.linode.com. Using an OAuth Client, a third-party developer may be given access to some, or all, of a User's account for the purposes of their application.

string
required
length between 1 and 512

Filterable The name of this application. This will be presented to users when they are asked to grant it access to their Account.

boolean
Defaults to false

Filterable If this is a public or private OAuth Client. Public clients have a slightly different authentication workflow than private clients. See the OAuth spec for more details.

url
required

The location a successful log in from login.linode.com should be redirected to for this client. The receiver of this redirect should be ready to accept an OAuth exchange code and finish the OAuth exchange.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json