> For the complete documentation index, see [llms.txt](https://docs.emsigner.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emsigner.com/apps-and-integrations/platform-integrations/microsoft-sharepoint/connecting-sharepoint-and-emsigner-and-configuring-the-workflow.md).

# Connecting SharePoint and emSigner & Configuring the Workflow

Learn how to establish secure connections between SharePoint and emSigner and set up the automation workflow

From emSigner: **Settings → Marketplace Integrations → Sharepoint**.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2F6ZTXjzGXpIl2HI5zfoP7%2Fimage.png?alt=media&amp;token=54b2fc8d-a3f2-49d8-8e09-82aedd1bc126" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FOsTzCsNXwbAt0LD1KJMO%2Fimage.png?alt=media&amp;token=e3041feb-b7a3-47c1-a31f-0f9b23453318" alt=""><figcaption></figcaption></figure>

#### **1.Connect emSigner**

Choose **emSigner**, add appropriate connection name, select instance (demo, qa, production), paste **AppName** and **SecretKey**, then click on **Connect**.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FuDY2ZW26EGbXigjXgfi5%2Fimage.png?alt=media&amp;token=d9e7e6ed-7e2d-493c-945e-049574e8e421" alt=""><figcaption></figcaption></figure>

#### **2.Connect SharePoint**

Click **Connect SharePoint** → enter a connection name (e.g. `Admin – ContosoSite`)->Click on **Connect** to follow Microsoft sign-in and grant Admin consent when prompted. Wait for the status to show **Connected**.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FxBseDMknhT86YMtdSoUg%2Fimage.png?alt=media&amp;token=515d7ddd-5689-4974-b802-e4ecf3bbc894" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FrHirwhMRZCeWjnktvqvs%2Fimage.png?alt=media&amp;token=37ed03a0-3fb8-47d7-9829-b3b29a1d19d2" alt=""><figcaption></figcaption></figure>

#### **3.Setup Workflow**

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FXpZ4ki8yOtl4waIwp3gT%2Fimage.png?alt=media&amp;token=0d034ca4-9aec-4f45-a46e-84c0187f62ad" alt=""><figcaption></figcaption></figure>

**3.1 Set Source (Monitor Folder)- New file from Sharepoint -> emSigner**

This workflow monitors a SharePoint folder and automatically sends new files to emSigner for signing.

**New File Created In Specific Location** Configure the folder emSigner should watch for incoming files:

* SharePoint Site — select the SharePoint site (e.g. *Konnectify emSigner integration*).
* Document Library ID — select the document library (e.g. *Documents*).
* Folder ID — select the specific folder to monitor for new files. Click Continue.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FRorpAvejiCP0TmDBFgbu%2Fimage.png?alt=media&amp;token=c54f9c0f-96fc-42d4-9ae1-d900ec739dc8" alt=""><figcaption></figcaption></figure>

**Get File** This step fetches the actual file content to pass into emSigner. Use the same site and library selected above:

* Site ID — select the same SharePoint site as above.
* Document Library ID — select the same library as above.
* File Item ID — click "Insert field" and select **Id** (this is the file identifier auto-passed from the previous step).
* Include File Content — set to **True**. Click Continue.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FIjASAvqeWjq4Kf7ST32l%2Fimage.png?alt=media&amp;token=24b0f5d3-e36a-41e1-91a9-11fa51725bac" alt=""><figcaption></figcaption></figure>

**Map emSigner Template**

Links the file to an emSigner template and assigns signatories. The fields below marked with \* are mandatory.

* **Template ID** — select the fixed-form template to be used for this workflow from the dropdown.
* **Initiator Email** — enter the email address of the emSigner account that will initiate the envelope (e.g. [*env\_demo@yopmail.com*](mailto:env_demo@yopmail.com)).
* **Reference No.** — click "Insert fields" → expand **Get File** → search `created date time` → select **Created Date Time**. This uses the file's creation timestamp as a unique reference.
* **Document Name** — click "Insert fields" → expand **Get File** → search `name` → select **Name**. This uses the SharePoint file name as the document label in emSigner.
* **Base64 File Data** — click "Insert fields" → expand **Get File** → search `content` → select **Content**. This passes the actual file content to emSigner for signing.
* **Request From** — enter a static text name to identify this workflow source (e.g. *Sharepoint*). *This value is critical — it must be reused exactly in the return workflow (emSigner → SharePoint) to match and route the signed file back to the correct folder. Keep a note of what you enter here.*
* **Signature 1 Signatory Email** — enter the signer's email address. For multiple signatories, fill in Signature 2, 3, etc. accordingly.
* **Signature 1 Name** — enter the signer's display name.

Optional fields such as selfie capture, redirect URL, and notification preferences can be configured as needed.

Once all required fields are filled, click **Save** to complete the source workflow configuration.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FUddzw8vye2UuMh55UYZn%2Fimage.png?alt=media&amp;token=21a8d9b8-33d1-436a-ae39-87a31d76637a" alt=""><figcaption></figcaption></figure>

**3.2 Configure Destination — emSigner signed file sync to SharePoint**

This workflow monitors emSigner for completed (signed) documents and automatically uploads them back to SharePoint. It has three steps.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FDc4lLOIyyhuDIIjBT3GU%2Fimage.png?alt=media&amp;token=50d3e4aa-d9fe-429c-aae4-289b70d278ce" alt=""><figcaption></figcaption></figure>

**Document Completed**

This step listens for a completed signing event in emSigner and filters it using the Request From value set in Step 3.1.

* Request From — enter the exact same value used in the source workflow (e.g. *Sharepoint*). This links the two workflows together so only documents originating from this SharePoint integration are picked up. Click **Continue**.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FoI1LpCa4w6uA0SbIX6fN%2Fimage.png?alt=media&amp;token=e05ff4e0-9bbf-4b1e-bc6e-1794e7f6afbd" alt=""><figcaption></figcaption></figure>

**Find Document by Workflow ID**

This step retrieves the signed document from emSigner using the workflow identifier passed from the previous step.

* Workflow ID — click "Insert fields" → expand **Document Completed** → select **WorkflowID**. This is auto-populated from the trigger above.
* Document ID — leave blank unless specifically required. Click **Continue**.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FTlvlPZsTod2XScyehoME%2Fimage.png?alt=media&amp;token=ceca83e2-f185-4896-a3ee-a522f042c464" alt=""><figcaption></figcaption></figure>

**Upload File**

This step uploads the signed file back to the destination SharePoint folder.

* Site ID — select the SharePoint site (e.g. *Konnectify emSigner integration*).
* Document Library ID — select the target library (e.g. *Documents*).
* File Name — click "Insert fields" → expand **Document Completed** → select **Document Name**.
* New File Content (Base64) — click "Insert fields" →expand **Find-Document-By-WorkflowId** → select **File List 0 Base64 File Data**. This maps the signed file content to be uploaded.
* Folder Path — enter the destination folder path where the signed file should be saved (e.g. *\File to be shared with emSigner*). Click **Continue**, then click **Save Mapping**.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FuvLeJbljWdPRjDptrwei%2Fimage.png?alt=media&amp;token=6790fc57-efce-4d86-a0e8-a91bad723b68" alt=""><figcaption></figcaption></figure>

***

**3.3 Enable Workflow**

Once both workflows are configured, toggle the enable switch on each workflow to activate them. The end-to-end automation is now live — new files dropped in the monitored SharePoint folder will be automatically sent to emSigner for signing, and once signed, the completed document will be returned to the designated SharePoint folder.

<figure><img src="https://1693119202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKpOPGIHdEkmaF2RQso%2Fuploads%2FuBReoegSPYhz2PdwtV38%2Fimage.png?alt=media&amp;token=a0117cf8-cac9-4d27-bf03-792ff8ab39b2" alt=""><figcaption></figcaption></figure>
