***

title: Integrate Postman with APIMatic
updated: 2025-10-03T00:00:00.000Z
slug: docs/integrations/available-integrations/apimatic
max-toc-depth: 2
----------------

Postman's APIMatic integration converts a Postman Collection into an API description format such as Swagger, RAML, or API Blueprint, and then periodically backs up the resulting file on GitHub.

## Prerequisites

To set up an APIMatic integration with Postman, you need:

* An [APIMatic account](https://www.apimatic.io/account/register)
* An API in your APIMatic account. You must create or import your API before you begin the integration.
* An [APIMatic API key](https://docs.apimatic.io/platform-api/#/http/guides/authentication/generating-authentication-keys/)
* A [GitHub account](https://github.com/)
* A GitHub repository to back up your collection

## Configure an APIMatic integration

1. From the **[Home](https://go.postman.co/home)** page, click **[Integrations](https://go.postman.co/integrations)**.

   <img alt="Home page and integrations" src="https://assets.postman.com/postman-docs/v10/home-integrations-v10.jpg" width="280px" />

2. Click **[Browse All Integrations](https://go.postman.co/integrations/browse?category=all)**.

3. Search for and select **APIMatic**.

4. Click **Add Integration**.

   ![Add APIMatic integration](https://assets.postman.com/postman-docs/v10/apimatic-add-integration-v10.jpg)

5. Your browser opens a new **Authorize Postman** page that gives Postman access to your GitHub repositories. Select **Authorize** for one of your GitHub repositories. Once the authorization process is complete, the page will tell you to close the tab and continue in Postman.

   <Info class="iconless-callout">
     If you aren't signed in to GitHub, you will be prompted to sign in.
   </Info>

6. Enter the following in the **Add Integration** window:
   * **APIMatic API Key** - Your [APIMatic API key](https://docs.apimatic.io/platform-api/#/http/guides/authentication/generating-authentication-keys/).
   * **Nickname** - A nickname for the integration.
   * **Workspace** - The workspace that has the collection you want to back up.
   * **Collection** - The collection you want to back up.
   * **Repository** - The GitHub repository you want to back up your collection to.
   * **Directory** - The directory in the GitHub repository to back up your collection to. If a directory with that name doesn't exist, it will be created when you add the integration.
   * **Filename** - A filename for the collection backup file.
   * **Format** - The format the collection is saved as.
   * **Branch** - The name of the GitHub branch to back up the collection to. This branch must already exist, and the integration process will fail if you specify an invalid branch name.

7. Click **Add Integration**.

Once the integration is created, click it to view details about the integration including its run log.

<img alt="APIMatic integration run log" src="https://assets.postman.com/postman-docs/apimatic-run-log-v9.jpg" />

Postman checks your collection for changes. If Postman identifies changes when it checks your collection, the changes automatically commit to your repository in JSON format.

<Info class="iconless-callout">
  **You can view your configured integrations on the [Browse Integrations](https://go.postman.co/integrations/browse) page.** You can also view integrations that have been configured for a collection by opening the collection and clicking <img alt="Info icon" src="https://assets.postman.com/postman-docs/aether-icons/state-info-stroke.svg#icon" width="16px" /> **Info** in the right sidebar. Learn more about [viewing or editing integrations](/docs/integrations/intro-integrations/#view-or-edit-integrations).
</Info>