GitLab

Integrations are available on Postman Team, Business, and Enterprise plans.

Back up your Postman Collections to GitLab, an open source Git repository manager, with the Postman 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.

Configuring a backup for Postman Collections in GitLab

1. In the Integrations tab for your workspace, select GitLab from the list of third party integrations.

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 can also click the Configured Integrations tab to set up other integrations, view available integrations for Gitlab, or view all integrations.

   

   The above screen provides you the following two options:

   • Backup your Postman Collections to GitLab
   • Backup your Postman Collections to GitLab on a custom domain

Backup your Postman Collections to GitLab

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

1. Enter your GitLab Personal Access Token and click Proceed.
2. In the Backup your Postman Collections page, choose an existing Postman Collection and your GitLab Project, enter a filename for your backup.

3. 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.

   

   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.

   

Backup your Postman Collections to GitLab on a custom domain

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

2. Enter your GitLab Personal Access Token, specify your Gitlab custom/self-hosted domain and click Proceed.

   Static IP Support

   If your network is behind a firewall that requires whitelisted IP addresses, you will need to use a static IP address to enable collection backups to GitLab on custom domains.

   Contact your IT team to whitelist the following static IP in your firewall to enable collection backups GitLab:

   • US East: 3.212.102.200

   Once you whitelist this IP address, calls for this integration will be able to connect to your network and allow the integration to work as expected.

3. In the Backup your Postman Collections page, choose an existing Postman Collection and your GitLab Project, enter a filename for your backup.
4. 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:

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.

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.

Note that the branch you want to back up your collection to must already exist.

Click Add Integrations.

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