Comment on page

createOAuthHandler

Create a fetch request handler to handle an OAuth authentication flow. The credentials are stored in the installation configuration as installationCredentialsKey.
See the Configurations section to learn more.
Argument
Type
Description
clientId*
string
ID of the client application in the OAuth provider.
clientSecret*
string
Secret of the client application in the OAuth provider.
authorizeURL*
string
URL to redirect the user to, for authorization.
accessTokenURL*
string
URL to exchange the OAuth code for an access token.
redirectURL
string
Redirect URL to use. When the OAuth identity provider only accepts a static one.
scopes
string[]
Scopes to ask for.
prompt
string
Optional configuration for a prompt during the OAuth process.
extractCredentials
function
Extract the credentials from the code exchange response.
*required
Example
const oauthHandler = createOAuthHandler({
            redirectURL: `${environment.integration.urls.publicEndpoint}/oauth`,
            clientId: environment.secrets.CLIENT_ID,
            clientSecret: environment.secrets.CLIENT_SECRET,
            authorizeURL: 'https://linear.app/oauth/authorize',
            accessTokenURL: 'https://api.linear.app/oauth/token',
            extractCredentials: (response) => {
                if (!response.ok) {
                    throw new Error(
                        `Failed to exchange code for access token ${JSON.stringify(response)}`
                    );
                }
​
                return {
                    configuration: {
                        oauth_credentials: { access_token: response.access_token },
                    },
                };
            },
});

Argument	Type	Description
`clientId`*	`string`	ID of the client application in the OAuth provider.
`clientSecret`*	`string`	Secret of the client application in the OAuth provider.
`authorizeURL`*	`string`	URL to redirect the user to, for authorization.
`accessTokenURL`*	`string`	URL to exchange the OAuth code for an access token.
`redirectURL`	`string`	Redirect URL to use. When the OAuth identity provider only accepts a static one.
`scopes`	`string[]`	Scopes to ask for.
`prompt`	`string`	Optional configuration for a prompt during the OAuth process.
`extractCredentials`	`function`	Extract the credentials from the code exchange response.

Last modified 7mo ago