# 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](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) 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="/files/RlGk0aOhm3FWWN3zI7zh" 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/ekm-insight-prebuilt-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.