Skip to main content
You are here: Integrations

Connect Mirata to SharePoint

Overview

Integrate Mirata with SharePoint to store PDFs and images from the form in SharePoint. The easiest way to do this is by leveraging Microsoft's Graph API, which provides a wide array of out-of-the-box functionality.

(1) Create an App Registration in Azure for Microsoft Graph

In you Azure account, you will need to provide permissions for interacting with you SharePoint site. You can provide only the permissions that are required for the actions you want to use Graph API for.

  1. Go to Azure Portal → App registrations → New registration

    • Leave everything besides Name as default → Register

  2. Copy these from the Overview page for later:

    • Application (client) ID

    • Directory (tenant) ID

  3. Go to Certificates & secrets → New client secret

    • Create a secret → Copy the value for later

  4. Go to API permissions → Add a permission → Microsoft Graph → Application permissions

(2) Create a Connection in Mirata Admin Tool

Like for all integrations in Mirata, start by creating a Connection.

DETAILS tab

Enter the same information as shown below:

AUTHENTICATION tab

Enter the same information as shown below:

HTTP REQUEST tab

Enter the same information as shown below.

Replace the Purple box with your Azure AD Tenant ID for your Microsoft 365 / SharePoint tenant. This is the Directory (tenant) ID value on the Overview page of your Azure account.

Configure the Body Fields section like below.

Replace the purple box next to client_id with your Application (client) ID from step 1.

Replace the purple box next to client_secret with the secret value from step 1.

CONFIGURATION tab

No need to add anything here.

(3) Create Integration Actions in Mirata Admin Tool

The Microsoft Graph API is a RESTful web API that lets you access, manipulate, and navigate Microsoft 365 and Azure resources via HTTP methods (GET, POST, PATCH, DELETE) at the endpoint https://graph.microsoft.com/{version}/{resource}

Learn more from Microsoft: Use the Microsoft Graph API

We'll show you one common example.

Send PDF of form to SharePoint

Below is an example set up to store a PDF of the form in SharePoint. The part that will be specific to your particular use case is the URL Path.

The URL path will need to follow this format: https://graph.microsoft.com/v1.0/sites/{site-id}/drives/{drive-id}/items/{parent-folder-id}:/{file-name}:/content

You can find more documentation from Microsoft here

To get the Site ID, add this: “/_api/site/id” to the end of the URL of your SharePoint Site, like “https://miratasoftllc.sharepoint.com/sites/MirataSite123/_api/site/id” 

Add a header key/value pair just like this:

Input Parameters

Like for all Integration Actions, you can create input parameters in the INPUTS tab and use them anywhere in the request by putting them in { } brackets like this: "{file-name}". If you're calling this action from a form workflow, you can dynamically map values to the input parameters.