---
title: Managing API Tokens
description: Essal Office provides a REST API for integrating with other systems — for example, automated document uploads from business applications, connecting a...
---

[Skip to content](https://help.essal.cloud/en/article/1489-#main-content)

English

Show submenu for translations

[More support](https://help.essal.cloud/en/kb-tickets/new?hsLang=en) [Customer portal](https://clients.essal.cloud/tickets?hsLang=en)

[![logo](https://help.essal.cloud/hubfs/logo.svg)](https://help.essal.cloud/?hsLang=en)

- [Home](https://essal.cloud/)
- [Products](https://essal.cloud/products)
- [Industries](https://essal.cloud/industries)
- [About](https://essal.cloud/about)
- [Contact](https://essal.cloud/contact)

Open main navigation

Close main navigation

- [Home](https://essal.cloud/)
- [Products](https://essal.cloud/products)
- [Industries](https://essal.cloud/industries)
- [About](https://essal.cloud/about)
- [Contact](https://essal.cloud/contact)
- English
  
  Show submenu for translations
- [More support](https://help.essal.cloud/en/kb-tickets/new)
- [Customer portal](https://clients.essal.cloud/tickets)
- [Home](https://essal.cloud/)

[Home](https://essal.cloud/)

 Essal Help Center

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.essal.cloud/en?hsLang=en)
2. [Essal Office](https://help.essal.cloud/en/essal-office?hsLang=en)
3. [Account and security](https://help.essal.cloud/en/essal-office?hsLang=en#account-and-security)

# Managing API Tokens

Essal Office provides a REST API for integrating with other systems — for example, automated document uploads from business applications, connecting a scanner workflow, or building custom integrations. API access is authenticated using **tokens** tied to specific user accounts.

---

## What Is an API Token?

An API token is a long random string that acts as a credential for programmatic access to Essal Office. Anything you can do in the web interface can potentially be done via the API using a token — under the same permissions as the user the token belongs to.

Keep tokens private. Anyone with a token has the same level of access as the user it was issued for.

---

## Creating an API Token

1. Go to your profile settings (click your username in the top-right)
2. Select **API Token** or navigate to **Profile \> API Token**
3. If no token exists yet, click **Generate token**
4. Copy the token immediately — it is shown in full only at creation time

Store the token in a secure location (e.g. a password manager or secrets vault). If you lose it, you must delete it and generate a new one.

---

## Using an API Token

Include the token in the `Authorization` header of all API requests:

`Authorization: Token`

The API base URL is typically `https://your-essal-office-domain/api/`. Refer to the API documentation for available endpoints and request formats.

---

## Rotating a Token

If a token is compromised or needs to be replaced:

1. Go to your profile settings → API Token
2. Delete the existing token
3. Generate a new token
4. Update all systems that used the old token with the new value

The old token stops working immediately upon deletion.

---

## Token Security Best Practices

- **Never share tokens** in emails, chats, or code repositories
- **Use one token per integration** — if one integration's token is compromised, only that integration is affected
- **Rotate tokens periodically** as a security hygiene measure
- **Review active tokens** — if you see a token you did not create, delete it and contact your administrator

---

## Admin Token Management

Administrators can view and manage API tokens for all users from the Administration panel. If a user account is compromised, admins can delete that user's token to revoke API access immediately without deleting the user account.

- [Essal Office](https://help.essal.cloud/en/essal-office?hsLang=en#main-content)

    - [Getting started](https://help.essal.cloud/en/essal-office?hsLang=en#getting-started)
    - [Searching and saved views](https://help.essal.cloud/en/essal-office?hsLang=en#searching-and-saved-views)
    - [Correspondents and document types](https://help.essal.cloud/en/essal-office?hsLang=en#correspondents-and-document-types)
    - [Email import](https://help.essal.cloud/en/essal-office?hsLang=en#email-import)
    - [Users groups and permissions](https://help.essal.cloud/en/essal-office?hsLang=en#users-groups-and-permissions)
    - [Sharing documents](https://help.essal.cloud/en/essal-office?hsLang=en#sharing-documents)
    - [Working with documents](https://help.essal.cloud/en/essal-office?hsLang=en#working-with-documents)
    - [Pdf tools](https://help.essal.cloud/en/essal-office?hsLang=en#pdf-tools)
    - [Uploading documents](https://help.essal.cloud/en/essal-office?hsLang=en#uploading-documents)
    - [Archive serial numbers](https://help.essal.cloud/en/essal-office?hsLang=en#archive-serial-numbers)
    - [Workflows and automation](https://help.essal.cloud/en/essal-office?hsLang=en#workflows-and-automation)
    - [Organizing with tags](https://help.essal.cloud/en/essal-office?hsLang=en#organizing-with-tags)
    - [Troubleshooting and faq](https://help.essal.cloud/en/essal-office?hsLang=en#troubleshooting-and-faq)
    - [Account and security](https://help.essal.cloud/en/essal-office?hsLang=en#account-and-security)
    - [Custom fields](https://help.essal.cloud/en/essal-office?hsLang=en#custom-fields)

- [Portal](https://admin.essal.cloud/)
- [Newsroom](https://newsroom.essal.cloud/)
- [Careers](https://careers.essal.cloud/)
- [Help](https://support.essal.cloud/)
- [Status](https://status.essal.cloud/)
- [Contact](https://essal.cloud/contact)
- [Terms](https://legal.essal.cloud/terms)

[![logo](https://help.essal.cloud/hubfs/logo.svg "logo")](https://essal.cloud/)

Essal LLC

<https://facebook.com/essal> <https://www.linkedin.com/company/essal> <https://github.com/essal>

Copyright © 2026, Essal