> 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

# some-operation

# Package: oauth-2

# Method link: https://dev.wix.com/docs/api-reference/app-management/oauth-2/request-an-access-token.md

## Permission Scopes:
undefined

## Introduction

Creates your app’s refresh token and an initial access token.

<blockquote class="warning">

Deprecated: This method is deprecated and is no longer available for new apps. Existing apps that already use [custom authentication (deprecated)](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/custom-authentication-legacy.md) can continue using it. To migrate to the new authentication, see [Authenticate Using OAuth](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/authenticate-using-oauth.md#migrate-from-custom-authentication-legacy).

</blockquote>

<blockquote class="important">

__Important:__
Authentication methods differ depending on whether you're building a [Wix app](https://dev.wix.com/docs/build-apps/get-started/overview/about-wix-apps.md) or a [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless.md) project.

* For apps using [custom authentication (legacy)](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/custom-authentication-legacy.md), this is the correct method.
* For apps using [OAuth](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/about-oauth.md), call [Create an Access Token](https://dev.wix.com/docs/rest/app-management/oauth-2/create-access-token.md).
* For headless projects, use one of the [authentication strategies for Wix Headless](https://dev.wix.com/docs/go-headless/get-started/setup/authentication/authentication-strategies.md).

</blockquote>

Wix sends your app the authorization code after a new user has completed the installation process and given your app permission to access their data.

You must pass the authorization code, your app ID, your app’s secret key, and `{"grant_type": "authorization_code"}` to create the refresh token and an initial access token.

---

## REST API

### Examples

### Create a custom authentication refresh and access token.
```curl
curl -X POST \
'https://www.wixapis.com/oauth/access' \
-H 'Content-Type: application/json' \
-d '{
  "grant_type": "authorization_code",
  "client_id": "<APP_ID>",
  "client_secret": "<APP_SECRET_KEY>",
  "code": "<AUTH_CODE>"
}'
```

---