---
title: Your first iManage REST API call
description: First iManage REST API call by TERRIT Wiktor Abramowicz
image: https://www.territ.pl/hubfs/Canva%20images/iManage%20REST%20API%20The%20first%20step-1.png
---

[Skip to content](https://www.territ.pl/articles/your-first-imanage-rest-api-call#main-content)

[![TERRIT logo](https://www.territ.pl/hs-fs/hubfs/Logog-slogan-1-1.png?width=509&height=353&name=Logog-slogan-1-1.png)](https://www.territ.pl)

- [Home](https://www.territ.pl/)
- [Articles](https://www.territ.pl/articles)

Open main navigation

Close main navigation

- [Home](https://www.territ.pl/)
- [Articles](https://www.territ.pl/articles)
- [Contact me](https://www.territ.pl/contact-me)

[Contact me](https://www.territ.pl/contact-me)

# Making your iManage run smoothly

 Jan 8, 2023 6:01:41 AM

# Your first iManage REST API call

![Picture of Wiktor Abramowicz](https://www.territ.pl/hs-fs/hubfs/face-sign-white.png?width=50&name=face-sign-white.png) [Wiktor Abramowicz](https://www.territ.pl/articles/author/wiktor-abramowicz)

Share: [facebook-f icon](http://www.facebook.com/share.php?u=https://www.territ.pl/articles/your-first-imanage-rest-api-call) [linkedin-in icon](http://www.linkedin.com/shareArticle?mini=true&url=https://www.territ.pl/articles/your-first-imanage-rest-api-call) [Twitter icon](https://twitter.com/intent/tweet?url=https://www.territ.pl/articles/your-first-imanage-rest-api-call) [pinterest-p icon](http://pinterest.com/pin/create/link/?url=https://www.territ.pl/articles/your-first-imanage-rest-api-call) [envelope icon](mailto:?body=https://www.territ.pl/articles/your-first-imanage-rest-api-call)

If you've always used SQL to make bulk changes in iManage Work or you've barely done a few SELECTs - it's gone now. We all have to start using REST API to communicate with the system. Fortunately, it gets much easier after you do the first step.

## The first step

It's universal for every operation and necessary to achieve anything - authentication. We are using the simplest one - with a username and password - as it's the easiest to implement and is recommended by iManage. What we get in return (a response) is an authentication token that we'll need to "attach" to every request we send later to let the system know that we are authenticated and authorized to perform the operation.

## The app

iManage recommends Postman and you're welcome to use it. I chose Insomnia as I found it easier to chain requests there.

## How to use it

The principle is very simple but the execution can be tricky. Errors that come back in response often aren't that helpful. I hope the manual below will save you a few hours I spent on making mistakes. Let me know how it goes.

You can also download it as a PDF to share with your colleagues.

[Your first iManage REST API call with Insomnia.pdf](https://www.territ.pl/hubfs/Your%20first%20iManage%20REST%20API%20call%20with%20Insomnia.pdf)

 

[iManage](https://www.territ.pl/articles/tag/imanage), [Insomnia](https://www.territ.pl/articles/tag/insomnia), [SQL](https://www.territ.pl/articles/tag/sql), [iManage Work](https://www.territ.pl/articles/tag/imanage-work), [Authentication](https://www.territ.pl/articles/tag/authentication), [Authorization](https://www.territ.pl/articles/tag/authorization), [REST API](https://www.territ.pl/articles/tag/rest-api)

## Related posts

[![TERRIT Logo](https://www.territ.pl/hs-fs/hubfs/TERRIT_logo_2-1.png?height=200&name=TERRIT_logo_2-1.png)](https://www.territ.pl/articles/how-to-install-imanage-work-on-prem-initial-steps)

[iManage](https://www.territ.pl/articles/tag/imanage), [SQL](https://www.territ.pl/articles/tag/sql), [iManage Work](https://www.territ.pl/articles/tag/imanage-work), [Work Desktop](https://www.territ.pl/articles/tag/work-desktop), [On-premises](https://www.territ.pl/articles/tag/on-premises), [Installation](https://www.territ.pl/articles/tag/installation)

## [How to install iManage Work on-prem - initial steps](https://www.territ.pl/articles/how-to-install-imanage-work-on-prem-initial-steps)

![Picture of Wiktor Abramowicz](https://www.territ.pl/hs-fs/hubfs/face-sign-white.png?width=50&name=face-sign-white.png) [Wiktor Abramowicz](https://www.territ.pl/articles/author/wiktor-abramowicz) 

 Feb 15, 2023 11:31:44 AM

iManage Work is a popular document and email management system used by many organizations...

[Read more](https://www.territ.pl/articles/how-to-install-imanage-work-on-prem-initial-steps)

[![](https://www.territ.pl/hs-fs/hubfs/Logog-slogan-1.png?height=200&name=Logog-slogan-1.png)](https://www.territ.pl/articles/how-to-use-imanage-imdbcheck-tool-to-fix-database-errors-and-ensure-a-successful-imanage-cloud-migration)

[iManage](https://www.territ.pl/articles/tag/imanage), [SQL](https://www.territ.pl/articles/tag/sql), [iManage Work](https://www.territ.pl/articles/tag/imanage-work), [REST API](https://www.territ.pl/articles/tag/rest-api), [imDBCheck](https://www.territ.pl/articles/tag/imdbcheck), [Cloud Migration](https://www.territ.pl/articles/tag/cloud-migration)

## [How to Use iManage imDBCheck Tool to Fix Errors for a Successful Cloud Migration](https://www.territ.pl/articles/how-to-use-imanage-imdbcheck-tool-to-fix-database-errors-and-ensure-a-successful-imanage-cloud-migration)

![Picture of Wiktor Abramowicz](https://www.territ.pl/hs-fs/hubfs/face-sign-white.png?width=50&name=face-sign-white.png) [Wiktor Abramowicz](https://www.territ.pl/articles/author/wiktor-abramowicz) 

 Feb 11, 2023 7:22:23 AM

iManage Work relies on a database for its daily operations. Errors and data inconsistencies can...

[Read more](https://www.territ.pl/articles/how-to-use-imanage-imdbcheck-tool-to-fix-database-errors-and-ensure-a-successful-imanage-cloud-migration)

[![Territ logo](https://www.territ.pl/hs-fs/hubfs/TERRIT_logo_2-1.png?height=200&name=TERRIT_logo_2-1.png)](https://www.territ.pl/articles/make-imanage-rest-api-requests-30x-faster-in-python)

[iManage](https://www.territ.pl/articles/tag/imanage), [iManage Work](https://www.territ.pl/articles/tag/imanage-work), [REST API](https://www.territ.pl/articles/tag/rest-api), [Cloud Migration](https://www.territ.pl/articles/tag/cloud-migration), [Multiprocessing](https://www.territ.pl/articles/tag/multiprocessing), [Python](https://www.territ.pl/articles/tag/python)

## [Make iManage REST API requests 30x faster in Python](https://www.territ.pl/articles/make-imanage-rest-api-requests-30x-faster-in-python)

![Picture of Wiktor Abramowicz](https://www.territ.pl/hs-fs/hubfs/face-sign-white.png?width=50&name=face-sign-white.png) [Wiktor Abramowicz](https://www.territ.pl/articles/author/wiktor-abramowicz) 

 May 28, 2024 11:31:12 AM

Here's a brief article on how I enhanced my Python script to update 63 documents per second instead...

[Read more](https://www.territ.pl/articles/make-imanage-rest-api-requests-30x-faster-in-python)

[![TERRIT logo](https://www.territ.pl/hs-fs/hubfs/Logog-slogan-1-1.png?width=509&height=353&name=Logog-slogan-1-1.png "TERRIT logo")](https://territ.pl)

TERRIT Wiktor Abramowicz

VAT EU: PL5272915549

wiktor@territ.pl

---

[Follow me on LinkedIn](https://www.linkedin.com/in/wiktor-abramowicz-39338093/)

```json
{
  "@context" : "https://schema.org",
  "@type" : "BlogPosting",
  "author" : {
    "@type" : "Person",
    "name" : "Wiktor Abramowicz",
    "url" : "https://www.territ.pl/articles/author/wiktor-abramowicz"
  },
  "dateModified" : "2023-01-08T05:01:41.928Z",
  "datePublished" : "2023-01-08T05:01:41.000Z",
  "headline" : "Your first iManage REST API call",
  "image" : [ "https://www.territ.pl/hubfs/Canva%20images/iManage%20REST%20API%20The%20first%20step-1.png" ],
  "mainEntityOfPage" : {
    "@id" : "https://www.territ.pl/articles/your-first-imanage-rest-api-call",
    "@type" : "WebPage"
  },
  "publisher" : {
    "@type" : "Organization",
    "logo" : {
      "@type" : "ImageObject",
      "url" : "https://www.territ.pl/hubfs/Logog-slogan-1-1.png"
    },
    "name" : "TERRIT"
  }
}
```