> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # GetOAuthApp # Package: headless # Namespace: OAuthAppService # Method link: https://dev.wix.com/docs/api-reference/business-management/headless/oauth-apps/get-oauth-app.md ## Permission Scopes: Read OAuth Apps: SCOPE.OAUTH_APP.READ ## Introduction Retrieves an OAuth app by ID. --- ## REST API ### Schema ``` Method: getOAuthApp Description: Retrieves an OAuth app by GUID. URL: https://www.wixapis.com/v1/oauth-apps/{oAuthAppId} Method: GET # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: oAuthAppId Method parameters: param name: oAuthAppId | type: none | required: true Return type: GetOAuthAppResponse - name: oAuthApp | type: OAuthApp | description: Retrieved OAuth app info. - name: id | type: string | description: GUID of the OAuth app. - name: createdDate | type: string | description: Date and time the OAuth app was created, in ISO 8601 format. - name: name | type: string | description: Display name of the OAuth app, as it appears in the dashboard. - name: description | type: string | description: Description of the OAuth app, as it appears in the dashboard. - name: loginUrl | type: string | description: External login URL to which users are redirected automatically to authenticate. If no login URL is specified, the user is redirected to Wix to authenticate. - name: allowedRedirectUris | type: array | description: List of URIs to which redirection from Wix is allowed after authentication. When a client redirects a user to Wix for authentication, the client provides a URI to redirect the user back to after the user has been authenticated. Wix only redirects the user if the exact URI is contained in this array. - name: allowedRedirectDomains | type: array | description: List of domains to which redirection from Wix is allowed after processes other than authentication. When a client redirects a user to a Wix page (for example, for checkout), the client provides a URL to redirect the user back to. Wix only redirects the user if the URL is in one of the specified domains. - name: allowSecretGeneration | type: boolean | description: For internal use only. - name: logoutUrl | type: string | description: External logout URL to which we invoke when user logout at wix. If no logout URL is specified, the user is logged out only at Wix. - name: applicationType | type: OAuthAppType | description: OAuth application type. - enum: - OAUTH_APP_TYPE_UNSPECIFIED: OAuth app type is not specified. - WEB_APP: OAuth app type is a web application. - MOBILE: OAuth app type is a mobile application. - OTHER: OAuth app type is some other type of application. - name: technology | type: OAuthTechnologies | description: OAuth technology used by the oauth application. - enum: - OAUTH_TECHNOLOGY_UNSPECIFIED: The OAuth technology is not specified. - JAVASCRIPT: OAuth technology using JavaScript. - ANGULAR: OAuth technology using Angular. - VUE: OAuth technology using Vue.js. - REACT: OAuth technology using React. - REACT_NATIVE: OAuth technology using React Native. - IOS: OAuth technology using iOS. - ANDROID: OAuth technology using Android. - OTHER_TECHNOLOGY: OAuth technology using some other kind of technology. - name: wixPagesDomainsMappings | type: array | description: List of domain mappings from external domains to Wix domains. When a user accesses a non-Wix domain, they can be automatically forwarded to the corresponding Wix domain based on these mappings. This enables domain-level redirection from external domains to Wix-hosted pages. - name: origin | type: string | description: - name: destination | type: string | description: - name: redirectUrlWixPages | type: string | description: Redirect url for Wix-hosted pages. ``` ### Examples ### Get an OAuth app by ID ```curl curl -X GET \ 'https://www.wixapis.com/oauth-app/v1/oauth-apps/adddb436-aa2c-474a-8f0e-af719f3acd5b' \ -H 'Authorization: \ -H 'Content-Type: application/json' \ ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.headless.OAuthAppService.getOAuthApp(oAuthAppId) Description: Retrieves an OAuth app by GUID. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: oAuthAppId Method parameters: param name: oAuthAppId | type: string | description: GUID of the OAuth app to retrieve. | required: true Return type: PROMISE - name: _id | type: string | description: GUID of the OAuth app. - name: _createdDate | type: Date | description: Date and time the OAuth app was created, in ISO 8601 format. - name: name | type: string | description: Display name of the OAuth app, as it appears in the dashboard. - name: description | type: string | description: Description of the OAuth app, as it appears in the dashboard. - name: loginUrl | type: string | description: External login URL to which users are redirected automatically to authenticate. If no login URL is specified, the user is redirected to Wix to authenticate. - name: allowedRedirectUris | type: array | description: List of URIs to which redirection from Wix is allowed after authentication. When a client redirects a user to Wix for authentication, the client provides a URI to redirect the user back to after the user has been authenticated. Wix only redirects the user if the exact URI is contained in this array. - name: allowedRedirectDomains | type: array | description: List of domains to which redirection from Wix is allowed after processes other than authentication. When a client redirects a user to a Wix page (for example, for checkout), the client provides a URL to redirect the user back to. Wix only redirects the user if the URL is in one of the specified domains. - name: allowSecretGeneration | type: boolean | description: For internal use only. - name: logoutUrl | type: string | description: External logout URL to which we invoke when user logout at wix. If no logout URL is specified, the user is logged out only at Wix. - name: applicationType | type: OAuthAppType | description: OAuth application type. - enum: - OAUTH_APP_TYPE_UNSPECIFIED: OAuth app type is not specified. - WEB_APP: OAuth app type is a web application. - MOBILE: OAuth app type is a mobile application. - OTHER: OAuth app type is some other type of application. - name: technology | type: OAuthTechnologies | description: OAuth technology used by the oauth application. - enum: - OAUTH_TECHNOLOGY_UNSPECIFIED: The OAuth technology is not specified. - JAVASCRIPT: OAuth technology using JavaScript. - ANGULAR: OAuth technology using Angular. - VUE: OAuth technology using Vue.js. - REACT: OAuth technology using React. - REACT_NATIVE: OAuth technology using React Native. - IOS: OAuth technology using iOS. - ANDROID: OAuth technology using Android. - OTHER_TECHNOLOGY: OAuth technology using some other kind of technology. - name: wixPagesDomainsMappings | type: array | description: List of domain mappings from external domains to Wix domains. When a user accesses a non-Wix domain, they can be automatically forwarded to the corresponding Wix domain based on these mappings. This enables domain-level redirection from external domains to Wix-hosted pages. - name: origin | type: string | description: - name: destination | type: string | description: - name: redirectUrlWixPages | type: string | description: Redirect url for Wix-hosted pages. ``` ### Examples ### getOAuthApp ```javascript import { oAuthApps } from '@wix/auth-management'; async function getOAuthApp(oAuthAppId) { const response = await oAuthApps.getOAuthApp(oAuthAppId); }; ``` ### getOAuthApp (with elevated permissions) ```javascript import { oAuthApps } from '@wix/auth-management'; import { auth } from '@wix/essentials'; async function myGetOAuthAppMethod(oAuthAppId) { const elevatedGetOAuthApp = auth.elevate(oAuthApps.getOAuthApp); const response = await elevatedGetOAuthApp(oAuthAppId); } ``` ### getOAuthApp (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { oAuthApps } from '@wix/auth-management'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { oAuthApps }, // Include the auth strategy and host as relevant }); async function getOAuthApp(oAuthAppId) { const response = await myWixClient.oAuthApps.getOAuthApp(oAuthAppId); }; ``` ---