Tickets for the 2019 Postman User Conference are available! Get your tickets now before they're gone. Learn more.

GitLab

Back up and synchronize your Postman Collections on GitLab (an open source Git repository manager) and on any of your custom domains. Your Collections are all tucked in safe and sound with our latest Postman Pro to GitLab Integration.

Setting up a GitLab integration requires you to get a GitLab Personal Access Token and configure how you would like to back up your collections.

Generating a GitLab Personal Access Token

Log in to GitLab.

If you don’t already have a Personal Access Token from GitLab, generate a new one.  

Save the generated token to use later.

gitlab create token

gitlab token

Configuring a backup for Postman Collections in GitLab

  1. In the Integrations page, find GitLab from Postman's list of 3rd party Integrations for Postman Pro/Enterprise.

select gitlab integration

  1. Click View Details to see information about GitLab and how it can back up your Postman Collections to your GitLab projects or self-hosted domains.

Note: You also can click the Configured Integrations tab to set up other integrations, view available integrations for Gitlab, or view all integrations.

gitlab add

The above screen provides you the following two options:

Backup your Postman Collections to GitLab

  1. Click the Add Integration button to enter your Gitlab token to start the integration.

gitlab add

  1. Enter your GitLab Personal Access Token and click Proceed.
  1. In the Backup your Postman Collections page, choose an existing Postman Collection and your GitLab Project, enter a filename for your backup.
  1. Click the Add Integration button. Your Collection is pushed to your GitLab project under the filename that you specified and saved as a single JSON file.

Now every change that is saved to your Postman Collection automatically commits changes to your GitLab project in real time. Your Collections and code can exist in the same repository.

backup

In "Advanced Options" you can enter a custom directory name or leave "Postman Collections" as the default. You can specify a branch for commit or the default branch of the repository will be used.

gitlab advanced options

Backup your Postman Collections to GitLab on a custom domain

  1. Click the Add Integration button to enter your Gitlab token to start the integration.

gitlab add

  1. Enter your GitLab Personal Access Token, specify your Gitlab custom/self-hosted domain and click Proceed.
  1. In the Backup your Postman Collections page, choose an existing Postman Collection and your GitLab Project, enter a filename for your backup.
  1. Click Add Integration. Your Collection is pushed to your GitLab project under the directory that you specified and saved as a single JSON file. This is illustrated in the following screen:

file in Gitlab project

Now every change that is saved to your Postman Collection automatically commits changes to your GitLab project in real time. Your Collections and code can exist in the same repository.

backup

In "Advanced Options" you can enter a custom directory name or leave "Postman Collections" as the default. You can specify a branch for commit or the default branch of the repository will be used. Make sure you have write access to the branch you are trying to push your changes.

gitlab advanced options

Click Add Integrations.

Now, you can go to your Gitlab domain and view your backed-up collections, as illustrated in the screen below:

gitlab advanced options

Upcoming Event

Postman POST/CON 2019