Skip to main content
Docs

create()

Creates a new with the given name and callback URL for an instance.

function create(params: CreateOAuthApplicationParams): Promise<OAuthApplication>

CreateOAuthApplicationParams

  • Name
    name (required)
    Type
    string
    Description

    The name of the new OAuth application.

  • Name
    redirectUris?
    Type
    string[] | null
    Description

    An array of redirect URIs of the new OAuth application.

  • Name
    scopes?
    Type
    string | null
    Description

    Scopes for the new OAuth application. Available scopes are profile, email, public_metadata, private_metadata. Defaults to profile email. Provide the requested scopes as a string, separated by spaces.

  • Name
    consentScreenEnabled?
    Type
    boolean | null
    Description

    Specifies whether the consent screen should be displayed in the authentication flow. Cannot be disabled for dynamically registered OAuth applications. Defaults to true.

  • Name
    pkceRequired?
    Type
    boolean | null
    Description

    Specifies whether the Proof Key of Code Exchange (PKCE) flow should be required in the authentication flow. Defaults to false.

  • Name
    public?
    Type
    boolean | null
    Description

    Indicates whether the client is public. If true, the Proof Key of Code Exchange (PKCE) flow can be used.

Example

Note

Importing clerkClient varies based on your framework. Refer to the for usage details, including guidance on .

const response = await clerkClient.oauthApplications.create({
  name: "oauthapp_123",
  redirect_uris: [
    ""
  ],
  scopes: "profile email public_metadata",
  public: null
})

Backend API (BAPI) endpoint

This method in the SDK is a wrapper around the BAPI endpoint POST/oauth_applications. See the BAPI reference for more information.

Feedback

What did you think of this content?
Edit this page on GitHub

Last updated on