---
updatedAt: 2026-03-19T15:06:23.000Z
agentTools:
  projectIndex: https://developers.miro.com/llms.txt
---

# Step 1: Create authorization request link

To obtain authorization for your app, you must create an authorization request link that you can send to users. The authorization flow begins by redirecting a browser to the authorization request link with a set of query parameters.

## Prerequisites

* [Create a Developer team in Miro](https://developers.miro.com/miro-ea/docs/create-a-developer-team)
* [Create your app in Miro](https://developers.miro.com/miro-ea/docs/rest-api-build-your-first-hello-world-app#step-1-create-your-app-in-miro)
* [Configure your app in Miro](https://developers.miro.com/miro-ea/docs/rest-api-build-your-first-hello-world-app#step-2-configure-your-app-in-miro)
* [Install your app in Miro](https://developers.miro.com/miro-ea/docs/rest-api-build-your-first-hello-world-app#step-3-install-the-app)

## Create the Authorization request link

**Authorization request link**

```
https://miro.com/oauth/authorize?response_type=code&client_id={required_client_id_value}&redirect_uri={required_redirect_uri_value}&state={optional_state_value}&team_id={optional_team_id_value}
```

**Authorization request link with line breaks**\
(We've added line breaks for better readability. Delete the line breaks for actual use.)

```
https://miro.com/oauth/authorize?response_type=code
&client_id={required_client_id_value}
&redirect_uri={required_redirect_uri_value}
&state={optional_state_value}
&team_id={optional_team_id_value}
```

**Where:**

| Query parameter                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Sample value                                             |
| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- |
| `response_type`<br />**required** | Indicates the response type. As we use the authorization code grant type, set the `response_type` query parameter value to `code`.                                                                                                                                                                                                                                                                                                                                                                                                                              | `code`                                                   |
| `client_id` **required**          | The Client ID of the app that is requesting for user authorization. To obtain your client ID: in Miro, [go to your apps](https://miro.com/app/settings/user-profile/apps). Then, in the **Created apps** section, click the app for which you want to obtain the Client ID. The Client ID appears in the **App Credentials** section.                                                                                                                                                                                                                           | `3074457363680401096`                                    |
| `redirect_uri`<br />**required**  | The URI of the page that you want to load after the user completed authorization. The URL must match the URL configured in the App Settings page.                                                                                                                                                                                                                                                                                                                                                                                                               | `[<https://localhost:3000`>]\(<https://localhost:3000`>) |
| `state`<br />*optional*           | Optional [OAuth 2.0 `state`](https://www.oauth.com/oauth2-servers/getting-ready/) parameter. It holds a random string generated by the app. After the user authorizes the app, the app checks that the same [`state`](https://datatracker.ietf.org/doc/html/rfc6749#section-4.1.1) value is returned to the URL defined in `redirectUri`. This check helps prevent [CSRF attacks](https://owasp.org/www-community/attacks/csrf). For request-specific data, you can use the `state` parameter to store data that will be included after the user is redirected. | `123xyz`                                                 |
| `team_id`<br />*optional*         | Specify the team ID to display the corresponding team name by default in the **Install & authorize** app window. To obtain the team ID for a specific team: in Miro, go to the **Profile Settings** page. In the **User & Team Management** section, click **Teams**. In the team list on the right pane, click the team name for which you want to obtain the team ID. Copy the team ID from the URL. Sample URL: `<https://miro.com/app/settings/team/3004457345010752790/users`>                                                                             | `3074457362577833142`                                    |

### Sample authorization request link with required query parameters

**Authorization request link**

```
https://miro.com/oauth/authorize?response_type=code&client_id=3074457363680401096&redirect_uri=https://localhost:3000/
```

**Authorization request link with line breaks**\
(We've added line breaks for better readability. Delete the line breaks for actual use.)

```
https://miro.com/oauth/authorize?response_type=code
&client_id=3074457363680401096
&redirect_uri=https://localhost:3000/
```

### Sample authorization request link with required and optional query parameters

**Authorization request link**

```
https://miro.com/oauth/authorize?response_type=code&client_id=3074457363680401096&redirect_uri=https://localhost:3000/&state=123xyz&team_id=3074457362577833142
```

**Authorization request link with line breaks**\
(We've added line breaks for better readability. Delete the line breaks for actual use.)

```
https://miro.com/oauth/authorize?response_type=code
&client_id=3074457363680401096
&redirect_uri=https://localhost:3000/
&state=123xyz
&team_id=3074457362577833142
```

# Sibling pages

* [Step 2: Request user for authorization](https://developers.miro.com/miro-ea/reference/request-user-for-authorization.md)
* [Step 3: Exchange authorization code with access token](https://developers.miro.com/miro-ea/reference/exchange-authorization-code-with-access-token.md)
* [Step 4: Use access token for REST API requests](https://developers.miro.com/miro-ea/reference/use-access-token-for-rest-api-requests.md)
* [Step 5: Get new access token using refresh token](https://developers.miro.com/miro-ea/reference/get-new-access-token-using-refresh-token.md)