Skip to main content

Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development.

  • 1,135 Topics
  • 3,453 Replies
1135 Topics
Mishal
MishalGroup Leader
posted in Developer platform and APIs
Integrating Google Calendar/sheets with Miro

Hi community! My team and I are working on exploring the possibility to read and write data from google calendar/sheets into a Miro board (through cards) I was curious to know and looking to connect with people who have explored this space using APIs etc. Any advice/guidance in achieving this is appreciated !

790
Mishal
O
ou812New Here
asked in Developer platform and APIs
Guest Embed boards

In our meeting platform, we want to automatically generate a miro board for each room and give any guest in the meeting the ability to edit the board, not just view it.Looking at the documentation, it seems like we can’t generate one of these guest, embedded Miro boards use the REST API directly, we have to present someone in the meeting with a boards picker and have them create the board. We would then capture the URL and send it to everyone else in the meeting automatically.Am I understanding the workflow correctly? Ideally, on our server, I would generate a Miro board for each room and populate our client apps with it. Guest joining the meeting would see the board immediately.

671
Joanna Smith
Mironeer
P
Pratik SutharBeginner
asked in Developer platform and APIs
How to position widget x and y coordinates automatically based on data using REST API?

We have to pass coordinates while creating the widget. Is there any way to do it easier? Miro Provide any solution for automatically creating or organizing boards based on data?

5431
Max Harper
A
Aaron LandersNew Here
asked in Developer platform and APIs
API Read-Only?

Can we create an image or a website capture using the API and add it to our board?

571
Max Harper
K
Kanishk RajvanshiNew Here
asked in Developer platform and APIs
Bad Token: The token was expected to have 3 parts, but got 1.; Reason: tokenInvalid

I am trying to create anonymous editable board for my customers but getting this error as soon as I click on to create a board without registration. Kindly please help in this, I am ready to provide whatever information is required from my end to resolve this issue at the earliest.Node.js Server:const jwt = require('njwt');app.post('/jwt', (req,res) => {    var claims = {        iss: 'XXX'    }    var Ejwt = jwt.create(claims,'XXX');    res.send(Ejwt);})Client Side Code:  async function getTokenFromServer() {    await fetch('/jwt', {          method: 'POST'        })    .then(res => res.json())    .then((data) => {        return data;    })  }

12611
Joanna Smith
Mironeer
Laflys
LaflysContributor
posted in Developer platform and APIs
Metadata updated are not persistent

Hello,There seems to be a problem with the update of the metadata. After an update, the metadata are reset to their creation values when the board is refresh.Is the problem known? If so, do you have any idea how long it will take to fix? Our plugins are all broken :) Thank you!

53325
Markus Smet
A
Afshin HoseiniBeginner
asked in Developer platform and APIs
Custom Widget

Hi there,How is it possible to make a custom widget by combining built in widgets?

5433
Max Harper
Daniel Wirtz
Daniel WirtzMiro Hero
asked in Developer platform and APIs
Error: 'url' field is required for ImageWidget

I’m currently trying to create images on a Miro board using the SDK. I have the images stored as base64 data URLs. But it seems the method isn’t accepting that format. Here the code I’m using: miro.board.widgets.create({ "type": "image", "url": "data:image/png;base64,iVBORw0KGgoAA..."})The error message I get: Error: 'url' field is required for ImageWidgetDoes the method only accept regular url’s? I wasn’t able to find an answer in the docs.  

1723
A
J
Jeff AndersonBeginner
asked in Developer platform and APIs
Tracking If Object is on top of another object on object move

Noob question here. I’d love to build some semantic “smarts to my use of miro. For instance: When I move a sticky Note (or some other shape inside of a column, shape with a label of developmentThen my web plugin would tag the sticky note as being in development and the current date  

402
J
M
Michał BartnickiNew Here
asked in Developer platform and APIs
Is it possible to change regular card into jira card and track it?

I would like to create cards using API and then make it ‘jira cards’ so that they can be tracked later on. Is this possible?I’ve checked how jira cards look like using api, but it seems that there are no custom fields or any metadata which would point jira plugin to related jira issue.Is there any way to manipulate jira plugin via api?

924
Anthony Roux
Mironeer
A
AnonymUserNew Here
posted in Developer platform and APIs
Possible to access LastMofiied in Web-plugin?

Hi there,the following code works great for me.wis = await miro.board.selection.get()text = wis[0].plainTextconsole.log(text)Now I would like to get the dates when the widget (sticker) was created and which date it has been last modified.I can’t find the correct documentation on this topic. Can someone help me?Kind regardsAustin

191
Anthony Roux
Mironeer
A
Aleph OfosevBeginner
asked in Developer platform and APIs
Custom Toolbar Panels in Web-plugins

Hi,I initially posted this topic in the Ideas forum, but I don’t think it was appropriate as the Ideas forum seems more oriented toward end-user new features. This is about a web-plugin feature, and maybe there already exists a solution or workaround, so I’m reposting it here, slightly reworded. Sorry for the duplication.--------------------------------I’m looking for a way to display “toolbar panels”, i.e. small panels on the right of the toolbar, that display options for the selected tool, like the ones that are displayed when selecting the Pen tool, Shape tool, Frame Tool, etc. For now, miro.board.ui allows to display a library (.openLibrary) or a sidebar (.openLeftSidebar), but they are rather bulky for some simple use cases, and one cannot decide their size.Actually, it should be possible to decide of the height and width of the toolbar panel, as the example above they may appear in different sizes -- e.g. something like openToolbarPanel(“my-toolbar-panel.html”, { width: “56px”, h

2931
Max Harper
S
StonelliBeginner
posted in Developer platform and APIs
Looking for a Miro developer for an extended card functionality

Hi,we’re looking into extending the functionality of the current cards on Miro.Firstly, I’m a simple Miro user, and have no idea of how to develop an app/ add-in, how to work with APIs, SDKs or whatsoever, all of that is cryptic to me. And that will stay so because I don’t need to.So I’m looking for someone who could develop an extended card function we can use.Basically I want to create a set of cards (think board game) which I can put on a Miro board. They have two sides: the front side has an image, a single sentence, and possibly a colour code (to group cards) – very similar to the existing card functionality.The back side is rich-text/ rich-media, containing text, tables, links, images, maybe videos, … (the default card functionality allows for bold/ italic text, for lists, and links, but nothing more, which is insufficient).It would be lovely if it created the impression that the card is flipped over, but just “expanding” it would work, too. It’s just important that I can fully c

2056
Adilson Simoes
M
Mark MarijnissenBeginner
posted in Developer platform and APIs
WebSDK & REST API

Users use an installation link to install the plugin. How do I get an access token to use for the REST API?The SDK only offers `miro.getIdToken`, but not an accessToken. Use CaseI have a plugin that can drag & drop elements into the Miro board. Users can purchase additional elements to drop. Therefore, I have a backend that keeps track of user purchases.Web SDK initializes plugin. I use `miro.getToken()` (deprecrated) in the Web SDK to retrieve a token. I make an API call to the backend, using this token. My backend uses https://api.miro.com/v1/users/me to retrieve the e-mail address. I cross-reference the e-mail with the purchases in the web-shop to unlock purchased products for this user (*)With the deprecation of `getToken()`, I cannot access the REST API anymore. The new idToken returns 401 Unauthorized.*) Actually ​​​​​​, this is a bit different, but doesn't matter for this context.

2981
Anthony Roux
Mironeer
S
saifisBeginner
asked in Developer platform and APIs
How to get drag and drop event to get coordinates

I’m making an app where dropping a card on top of a shape object needs some functions to be called, so I want to catch when cards are moved, I tried using “WIDGETS_TRANSFORMATION_UPDATED”  but it doesn’t give coordinates, I’ve tried getting the common ‘dragend’ on document and it did no go well either, any suggestions would be greatly appreciated.

32783
J
M
mrowe23New Here
asked in Developer platform and APIs
Suggestions/Proxy Application Templates for Azure?

Hello,We are looking to integrate creating and displaying MIRO boards in SharePoint Online.  It looks like MIRO doesn’t allow cross domain REST calls(CORS security) from the browser.  We are looking to create a web application in Azure to be a proxy. Is there any Azure articles/apps already created for MIRO proxies that can help us get started?  Thank you,Mike 

732
M
G
Gaurav YadavNew Here
asked in Developer platform and APIs
DOMException: Failed to execute 'postMessage' on 'Window': Response object could not be cloned.

When using `Editable boards for not registered users`, when I click on “Create Board”, I am getting an alert message saying “miro.com says Something went wrong” and in my console I get 2 errors`DOMException: Failed to execute 'postMessage' on 'Window': Response object could not be cloned.``Uncaught (in promise) DOMException: Failed to execute 'postMessage' on 'Window': Response object could not be cloned.` It works fine for users that have already registered with Miro. I have attached the necessary screenshots below.Error when clicking on “Create Board”Code for opening the board picker   

88722
G
D
David RichardsonNew Here
posted in Developer platform and APIs
Extract Card Names From a Board

Hi.I need to extract the names of cards from a board programmatically.Been reading your REST API documentation.Am confused about how to generate the access token.We use Azure AD as our Authorisation Server.Do you have some really simple examples of how to do this?Many thanks.Dave.

1063
Anthony Roux
Mironeer
N
NiucoBeginner
asked in Developer platform and APIs
Developer Account

Hello, I'm developing an App but I have to test it by using an endpoint that is just available for Paying accounts. Is there any developer account for this case? Cheers

1385
Anthony Roux
Mironeer
ronny
ronnyContributor
asked in Developer platform and APIs
Upload image into board

I managed to upload the logo of the board via the picture endpoint (https://developers.miro.com/reference#create-or-update-picture). How can I upload an image to the board itself? Use case: We want to upload our logo via the API when creating new boards.

53556
Anthony Roux
Mironeer
M
Mariappan SubramanianNew Here
asked in Developer platform and APIs
Getting user is not in account when hitting share board api

Hi, As per documentation `https://api.miro.com/v1/boards/id/share` requires array of emails Array of emails of users who you want to invite to the board. These users can be registered or non-registered.When I try with a non-registered user it gives the error ‘user is not in the team’. Why is it so? Can’t we invite someone who is not in the team even if it’s a public shared board? If we need to do this, should we initially hit the invite to team endpoint & then call this endpoint. Response: 400 "{ "status" : 400, "code" : "userIsNotInAccount", "message" : "User is not in account", "type" : "error" }"

3871
Anthony Roux
Mironeer
P
PetterNew Here
asked in Developer platform and APIs
Miro enterprise license - whiteboard, chat and video with guests

Hi all,We have an enterprise plan with Miro, and we want to use both chat and video with our guest users. We are planning to integrate Miro with ServiceNow, create a board via REST API, and then sharing the link with our users so they can share a whiteboard session including chat & video.Is it possible to use both chat AND video with guest users, if you have an enterprise plan? Also, is it possible to use some sort of templating for the boards you create? Like adding some text, or welcoming message on the board when it opens? Best regards,P

751
Rich Moore
Mironeer
Bentley Davis
Bentley DavisBeginner
posted in Developer platform and APIs
Error when using Airtable (and other npm packages) with create-miro-app React Typescript

Has anyone else tried using libraries with the create-miro-app React TypreScript option? I followed the Hello World Miro example and it works fine but when I add Airtable and even though none of the Airtable code runs I receive the error:Uncaught Error: Module "stream" has been externalized for browser compatibility and cannot be accessed in client code. at Object.get (browser-external:stream:3) at node_modules/node-fetch/lib/index.mjs (index.mjs:10) at __init (chunk-EB7XYW2R.js?v=d66c9224:9) at node_modules/airtable/lib/fetch.js (fetch.ts:2) at __require2 (chunk-EB7XYW2R.js?v=d66c9224:12) at node_modules/airtable/lib/base.js (base.ts:4) at __require2 (chunk-EB7XYW2R.js?v=d66c9224:12) at node_modules/airtable/lib/airtable.js (airtable.ts:1) at __require2 (chunk-EB7XYW2R.js?v=d66c9224:12) at dep:airtable:1I have spent several hours looking it up and trying different options but even though the error changes I have not been able to make it work. Here is a sa

6914
A
J
John RocheBeginner
asked in Developer platform and APIs
User Bearer Token returning Unauthorised from API call.

I have a user on the system whose User Bearer Token is returning Unauthorised when we call the Miro API. Other users bearer tokens are fine with the same calls.Can you please let me know how to refresh the bearer token for this user or enable this token to be authorized?This user has many associated boards which they will still need to be able to retrieve.

1854
J
K
Kamalesh JoshiNew Here
posted in Developer platform and APIs
Uncaught in promise error

I am developing a plugin using web api, where I read the miro board contents from javascript:Sample code:async function javascriptFunction() {          let selectedWidgets = await miro.board.selection.get() }This code works fine first time, but when the app is launched again, it gives error: Uncaught (in Promise) TypeError: cannot read property 'selection’ of undefined.  Anyone else faced this issue? 

3351
Anthony Roux
Mironeer
Terms & Conditions