> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/ekm-insight-prebuilt-connector.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.