---
updatedAt: 2026-03-19T19:38:08.000Z
agentTools:
  projectIndex: https://developers.miro.com/llms.txt
---

# 2) Build a full-stack Miro app

In this training you leverage the Miro Web SDK and REST API to create a full-stack Miro app.

[block:html]
{
  "html": "<label for=\"file\"><strong>Progress:</strong></label><br>\n<progress id=\"file\" value=\"80\" max=\"100\"  data-guide-id=\"fullstack-1\"></progress>"
}
[/block]

## Time to complete

<span><img alt="Time to complete" src="https://files.readme.io/1db0e9f-time-clock-blue-2.svg" width="24" ></span> \~45 minutes

> ❗️ Deprecated training
>
> Please note this training has been deprecated and will soon be replaced with an updated video and guide. Please see our guide on **[Build your first Hello, World app](https://developers.miro.com/docs/build-your-first-hello-world-app)** for detailed instructions on how to create a full-stack, boilerplate application on Miro.

[block:embed]
{
  "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fqd8GesfRXrk%3Ffeature%3Doembed&display_name=YouTube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dqd8GesfRXrk&image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Fqd8GesfRXrk%2Fhqdefault.jpg&key=7788cb384c9f4d5dbbdbeffd9fe4b92f&type=text%2Fhtml&schema=youtube\" width=\"854\" height=\"480\" scrolling=\"no\" title=\"YouTube embed\" frameborder=\"0\" allow=\"autoplay; fullscreen\" allowfullscreen=\"true\"></iframe>",
  "url": "https://www.youtube.com/watch?v=qd8GesfRXrk",
  "title": "Training: Build a fullstack Miro app",
  "favicon": "https://www.google.com/favicon.ico",
  "image": "https://i.ytimg.com/vi/qd8GesfRXrk/hqdefault.jpg",
  "provider": "youtube.com",
  "href": "https://www.youtube.com/watch?v=qd8GesfRXrk",
  "typeOfEmbed": "youtube"
}
[/block]

> 📘 Recommended onboarding tasks
>
> * [5: join the conversation](https://developers.miro.com/miro-ea/docs/task-5-join-the-conversation)
> * [6: install a Marketplace app](https://developers.miro.com/miro-ea/docs/task-6-install-a-marketplace-app)
> * [7: add Mirotone to an existing app](https://developers.miro.com/miro-ea/docs/task-7-add-mirotone-to-an-existing-app)
> * [Training: create your 1st Miro app locally](https://developers.miro.com/miro-ea/docs/training-1-create-your-1st-miro-app-locally)

## Learning objective

<span><img alt="Learning objective" src="https://files.readme.io/caef76f-learn-engineering-wrench-color.svg" width="24" ></span> After completing this training module, you'll be able to:

* Understand how to enable REST API authentication from Miro's Web SDK authorization
* Construct a full stack application using Miro's Web SDK for a frontend experience, and Miro's REST API for backend actions
* Create an API handler endpoint within the Miro NextJS boilerplate app

### Training Companion Guide

<details>
    <summary>View text summary</summary>

**\[00:20 - 01:22]**

* Training overview
* Miro developer platform guided onboarding

**\[01:20 - 01:40]**

* Recommended onboarding tasks
  * [Join the conversation](https://developers.miro.com/docs/task-5-join-the-conversation)
  * [Install a Marketplace app](https://developers.miro.com/docs/task-6-install-a-marketplace-app)
  * [Add Mirotone to an existing app](https://developers.miro.com/docs/task-7-add-mirotone-to-an-existing-app)
  * **Training**: [Create your 1st Miro app locally](https://developers.miro.com/docs/training-1-create-your-1st-miro-app-locally)
* Recap: Create your 1st Miro app locally

**\[02:04 - 04:18]**

* Web SDK + REST Authorization
  * A “fullstack” Miro app is an app that uses both the Web SDK and REST API
  * Diagram: end to end flow
* Why use joint authorization?
  * Ensure that end users don’t have to authorize the Web SDK and REST API separately

**\[04:20 - 08:06]**

* Developer App Settings
  * “Use this URI for SDK authorization”
    * Enable the SDK and REST API authorization to communicate seamlessly
  * **Demo**: Enable developer settings
    * Run app from the console
    * Authorize from the UI
    * Log OAuth2.0 `code` in the console to demonstrate where REST authorization is
    * kicked off during authorization from the frontend (Web SDK)
  * Recap: Joint authorization in action

**\[08:10 - 10:34]**

* Web SDK: Create images
  * Leveraging `createImage()` method in the Web SDK to create an image
  * **Demo**: create image on click
    * In `index.tsx`, create an `sdkHandler()` function to create an image
    * onClick, button calls `sdkHandler()`

**\[10:36 - 15:55]**

* REST API: Read images
  * Leverage REST API endpoint, GET Image to read image details
  * **Demo**: create a REST API handler
    * In `index.tsx`, create a `restHandler()` function to call our backend
    * Create a `restRequest.ts` endpoint under pages > api in our NextJS app
      * Call the Miro API client from the initMiro file in our boilerplate
      * GET board details, and retrieve images from the board
    * Back in `index.tsx`, retrieve the content we’re calling in our backend (`restRequest.ts`) in a new `async function apiCall()`
    * Expose these details in the frontend console
    * onClick, image details sent to the frontend console via the REST API
  * Recap: REST API
    * Created an API Handler endpoint
    * Leveraged the Miro API Client in our NextJS boilerplate
    * Called our API Handler from the frontend
  * REST API Reference App
    * Similar example, **[Webhooks Manager](https://github.com/miroapp/app-examples/tree/main/examples/webhooks-manager)** sample app

**\[15:58 - 17:05]**

* Learning summary
  * Miro’s learning paths
  * Authorization overview
  * Developer App Settings
  * Web SDK
  * REST API
* Guided learning path preview

</details>

## Associated skills

<span><img alt="Associated skills" src="https://files.readme.io/205cd4b-chain-link-color.svg" width="24" ></span> By following this training, you become familiar with these concepts and skills:

* Create a sample app with npm: [`create-miro-app`](https://www.npmjs.com/package/create-miro-app)
* Web SDK [board methods](https://developers.miro.com/docs/board_board#methods)
* Web SDK board methods: [`createStickynote()`](https://developers.miro.com/docs/board_board#createstickynote)
* [REST API](https://developers.miro.com/reference/api-reference)
* Enable REST API authentication from Miro's Web SDK authorization

## See also

* Sample App: [Webhooks Manager](https://github.com/miroapp/app-examples/tree/main/examples/webhooks-manager)

[block:html]
{
  "html": "<div class=\"js-guide-complete\" data-guide-id=\"fullstack-1\"></div>"
}
[/block]

# Sibling pages

* [1) Create your 1st Miro app locally](https://developers.miro.com/miro-ea/docs/training-1-create-your-1st-miro-app-locally.md)

# What's next

* [Explore our sample apps!](https://github.com/miroapp/app-examples#miro-app-examples)