---
title: "How to use Postman?"
slug: "getting-started-with-postman"
status: "custom"
updated: 2023-03-09T09:47:15Z
published: 2023-03-09T09:47:15Z
canonical: "apidocs.document360.com/getting-started-with-postman"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use Postman?

#### Postman + Document360

Postman is an API platform for building and using APIs. Postman also provides a platform for [API documentation](https://document360.com/blog/api-documentation/). Linking your Document360 project with Postman is easy and can be completed in a few minutes. You can use the on-premise or web-based Postman.

          Helpful links - Postman

          

- [How to download Postman application?](https://www.postman.com/downloads/)
- [How to install and update Postman application?](https://learning.postman.com/docs/getting-started/installation-and-updates/)
- [How to use Postman?](https://learning.postman.com/docs/)
- [FAQs in Postman](https://support.postman.com/hc/en-us)

---

## Linking your Document360 project in Postman

The below steps are based on the on-premise Postman application.

1. Open **Postman** application in your computer ![1_Screenshot-Import_option_PM](https://cdn.document360.io/2b5c503e-f283-4987-b5a8-2b71b454ecec/Images/Documentation/1_Screenshot-Import_option_PM.png)
2. In the 'My Workspace' section, click the **Import** button and an **Import** popup window appears ![2_Screenshot-Import_link_PM](https://cdn.document360.io/2b5c503e-f283-4987-b5a8-2b71b454ecec/Images/Documentation/2_Screenshot-Import_link_PM.png)
3. Select the **Link** option
4. Enter the below URL in the field `https://apihub.document360.io/swagger/v2/swagger.json`
5. Click **Continue** → **Import** ![3_Screenshot-Import_button_PM](https://cdn.document360.io/2b5c503e-f283-4987-b5a8-2b71b454ecec/Images/Documentation/3_Screenshot-Import_button_PM.png)
6. Wait for a few seconds and the Import complete page appears
7. Click **Close**

This action will create a sample request for each endpoint, allowing you to make the request quickly.

---

### Authentication

![4_Screenshot-Authentication_project](https://cdn.document360.io/2b5c503e-f283-4987-b5a8-2b71b454ecec/Images/Documentation/4_Screenshot-Authentication_project.png)

1. In the tree view, expand **Document360 Customer API** → **draft** and click **Document360 Customer API** under **draft**
2. In the main window, the **Authorization** tab appears as the default selection
3. Enter the API token in the **Value** field.  

For generating an API token, see [Generating token](https://apidocs.document360.com/docs/api-token).

          **How to get the API key?**

          

a. In the Knowledge base portal, click **Settings** → **Knowledge base portal** → **API tokens** b. Create the desired API token and copy the token (or) Copy the token from an existing token

![5_Screenshot-Variables_project_Save](https://cdn.document360.io/2b5c503e-f283-4987-b5a8-2b71b454ecec/Images/Documentation/5_Screenshot-Variables_project_Save.png)

1. Go to the **Variables** tab and type in `https://apihub.document360.io` in the **INITIAL VALUE** and **CURRENT VALUE** fields for the base URL
2. Click **Save**

The project authentication is completed. Now you can easily access all the available endpoints and perform various actions.

---

### Use cases

With the help of Postman, you can perform various actions in Document360. Here are a few basic use cases for your reference

- [How to create and publish an article?](/v2-api/apidocs/how-to-create-and-publish-an-article)
- [How to update a published article?](/v2-api/apidocs/how-to-update-a-published-article)
- [How to update SEO details?](/v2-api/apidocs/how-to-update-seo-details)