---
sourceDocument: Zurich Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/integrate-applications

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the Miro spoke

# Set up the Miro spoke {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read

Integrate the ServiceNow instance and Miro by
creating a custom OAuth application in Miro to authenticate ServiceNow requests.

## Before you begin

* Request an Integration Hub subscription.
* Activate the Miro spoke.
* Role required:
  * ServiceNow admin
  * Miro Company Admin
  {#setup-miro__ul_jk3_dcq_c2c}
{#setup-miro__ul_agy_qxd_rlb}

## Create a Miro Enterprise OAuth 2.0 application {#ariaid-title2}

Create a Miro Enterprise OAuth 2.0 application to enable access to the
Miro API.

### Before you begin

Role required: Miro company admin.

### Procedure

1. From a web browser, open the [Miro Platform](https://developers.miro.com/docs).
2. If you have not created any teams within your organization or you want to build and test the OAuth 2.0 application using fake data, [get a developer team](https://miro.com/app/dashboard/?createDevTeam=1).
3. On the page header of the Miro Platform, click Your Apps.  
   The sign up page opens.
4. Sign in using your Company Admin credentials.  
   Your default organization profile opens.
5. At the top of the left navigation pane, click the organization profile icon to select the organization that you want to build the OAuth 2.0 application for.  
   The profile for the selected organization opens.
6. On the left navigation pane, click Profile settings.
7. Select the API, SDK \& Embed tab of your profile settings.
8. In the Your apps section, select the I agree to the Terms and Conditions check box and then click Create new app.  
   The Create new app dialog box opens.
9. On the dialog box, fill in the fields.  
   {#create-app-miro__table_qjt_rzb_p4b__entry__2}

   | Field | Description |
   |-|-|
   | App name | Name of the OAuth 2.0 application. |
   | Description | Brief description of the OAuth 2.0 application. |
   [Table 1. Create new app dialog box]

   {#create-app-miro__table_qjt_rzb_p4b}
10. Select the team that you want to build the OAuth 2.0 application for.
11. Click Create app.  
    The settings for your newly created app open.
12. In the Your app \<<var class="keyword varname">app-name</var>\> section, copy the values in the Client id and Client secret fields.  
    Save them in a secure location for later use.
13. In the Redirect URLs section, enter the URL of the OAuth provider that users are redirected to after authentication and then click Add.  
    Enter <kbd class="ph userinput">https://<var class="keyword varname">instance</var>.service-now.com/oauth_redirect.do</kbd>, where \<<var class="keyword varname">instance</var>\> is the name of your ServiceNow instance.
14. In the OAuth scopes section, enable the organizations:read OAuth scope.  
    OAuth scopes specify the level of access that the application has to your protected resources. The organizations:read OAuth scope enables your application to read information about your organizations and organization members.
{#create-app-miro__steps_eml_zrs_p4b}

### What to do next

Keep your organization profile open so that you can enable SCIM (System for Cross-domain Identity Management) on your Miro Enterprise account.

## Enable SCIM on your Miro Enterprise account {#ariaid-title3}

Enable SCIM (System for Cross-domain Identity Management) on your Miro Enterprise account so that you can generate an API access token for
authenticating your Miro API requests.

### Before you begin

Role required: Miro Company Admin

### Procedure

1. On the left navigation pane of your Miro organization profile, click Security.
2. On the Security page, select the option to Enable SSO/SAML.
3. After SSO/SAML is enabled, select the option to enable SCIM Provisioning.  
   Miro automatically generates and displays your API access token in the Api Token field.
4. **Optional:** Select the Send email notifications to users provisioned by SCIM check box to allow Miro to send email notifications to all users that have been provisioned using SCIM.
5. Copy the API access token in the Api Token field.  
   Save it in a secure location for later use.
{#enable-scim-miro__steps_kw2_dss_p4b}

## Create a Miro Enterprise connection {#ariaid-title4}

Create a connection between your Miro Enterprise applications and your
ServiceNow instance.

### Before you begin

Role required: admin

### Procedure

1. From your ServiceNow instance, navigate to AllProcess AutomationWorkflow Studio.  
   The Workflow Studio launches in a new tab.
2. Click the Integrations tab.
3. Under Connections, the Outbound connections are displayed by default.
4. Click View Details for your Miro Enterprise connection.
5. From your Miro Enterprise connection details, click Add Connection.  
   The Create Connection dialog box opens.
6. On the dialog box, fill in the fields.  
   {#create-connection-miro__table_xd2_qht_lnb__entry__2}

   | Field | Description |
   |-|-|
   | Connection Information ||
   | Connection Name | Name of the Miro Enterprise connection. This field populates automatically. |
   | Credential Information ||
   | OAuth Client ID | Client ID that is assigned to your Miro Enterprise OAuth 2.0 application. |
   | OAuth Client Secret | Client secret that is assigned to your Miro Enterprise OAuth 2.0 application. |
   | OAuth Redirect URL | URL of the OAuth provider that users are redirected to after authentication. This field populates automatically based on the redirect URL that you specified in [Create a Miro Enterprise OAuth 2.0 application](https://www.servicenow.com/docs/B6EpvqwpiiNzYKuoKPSw0g#create-app-miro "Create a Miro Enterprise OAuth 2.0 application to enable access to the Miro API."). |
   [Table 2. Create Connection dialog box]

   {#create-connection-miro__table_xd2_qht_lnb}
7. Click Create and Get OAuth Token.  
   The Miro OAuth authorization dialog box opens.
8. On the dialog box, locate the team that you built the Miro Enterprise OAuth 2.0 application for and then click Install.  
   The OAuth access token becomes available for authorizing your Miro Enterprise connection.
{#create-connection-miro__steps_pd1_gss_p4b}

## Create a Miro Enterprise SCIM connection {#ariaid-title5}

Create a connection between the Miro Enterprise SCIM and your ServiceNow instance.

### Before you begin

Role required: admin

### Procedure

1. From your ServiceNow instance, navigate to Process AutomationFlow Designer.  
   The Flow Designer launches in a new tab.
2. Select the Connections tab.
3. Click View Details for your Miro Enterprise SCIM connection.
4. From your Miro Enterprise SCIM connection details, click Add Connection.  
   The Create Connection dialog box opens.
5. On the dialog box, fill in the fields.  
   {#create-connection-miro-scim__table_xd2_qht_lnb__entry__2}

   | Field | Description |
   |-|-|
   | Connection Information ||
   | Connection Name | Name of the Miro Enterprise SCIM connection. This field populates automatically. |
   | Credential Information ||
   | API Token | API access token for authenticating Miro API requests. Enter the same API access token that you generated and copied in [Enable SCIM on your Miro Enterprise account](https://www.servicenow.com/docs/B6EpvqwpiiNzYKuoKPSw0g#enable-scim-miro "Enable SCIM (System for Cross-domain Identity Management) on your Miro Enterprise account so that you can generate an API access token for authenticating your Miro API requests."). |
   [Table 3. Create Connection dialog box]

   {#create-connection-miro-scim__table_xd2_qht_lnb}
6. Click Create Connection.
{#create-connection-miro-scim__steps_jqg_pf3_p4b}

*[\>]: and then