# EKM Insight (prebuilt connector)

## Description

**EKM Insight** is a leading managed print service (MPS) software supplier, helping customers optimise print and imaging operations.

## API documentation

API documentation for **EKM Insight** requires EKM  Insight login credentials. 

## Authentication 

When adding connector instances for **EKM Insight**, the following authentication methods are supported:

* [API key & bearer](#api-key-and-bearer-authentication)

### API key & bearer authentication

When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **API key & bearer** authentication, the credentials below are prompted:

<table><thead><tr><th>Credential</th><th width="145" data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>base URL</code></td><td>true</td><td>Enter your EKM Insight URL - for example: <code>test.insightportal.net/PortalAPI</code></td></tr><tr><td><code>key</code></td><td>true</td><td>Enter your EKM Insight API key. This is obtained via the EKM Insight portal - go to <strong>system administration</strong> <mark style="color:red;">|</mark> <strong>Insight API</strong> <mark style="color:red;">|</mark> <strong>API users</strong>:<br><br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Ff5uqLmKQstHLOp8Ol5iG%2Fekm%20api%20creds.png?alt=media&#x26;token=b884b72d-8697-41be-a0ea-e7a1d1fcf682" alt=""></td></tr><tr><td><code>secret</code></td><td>true</td><td>Enter your EKM Insight API secret (see above).</td></tr></tbody></table>