How to Get Started with GitLab on Zapier

Last updated:

To get started with GitLab on Zapier, first you will need to click to connect your GitLab account to use with your Zap.

Click to connect GitLab

You'll be asked for connection details about your GitLab instance. If you use GitLab.com you don't need to do anything but click 'Yes, Continue'.

Note that your connected account will require "Maintainer" permissions, as the app uses web hooks and thus needs the "Configure project hooks" privilege. See GitLab's docs for details.

Hosted GitLab Config

If your team hosts its own instance of GitLab, you must first add Zapier as an application to your GitLab account, In another browser tab or window, log into your GitLab account, go to "Settings", then click on "Applications". From there:

  • Enter "Zapier" as an application name.
  • Enter https://zapier.com/dashboard/auth/oauth/return/GitLabCLIAPI/ in the "Redirect URI" field, making sure to include the trailing slash.
  • Be sure to select the checkboxes for "api" and "read_user" under "scopes".

When you're done, click "Save application".

GitLab OAuth App Setup

You should see a page like the following. Now you have all the info you need to connect your GitLab account to Zapier. Keep this it open so you can cut and paste the values into your Zap connection setup.

GitLab OAuth App Confirmation

Now in your Zapier Connected Account setup window enter the following information:

  • For GitLab Hostname, use the host name part from your GitLab URL. Leave off https:\\. If you logged into GitLab at https://www.example.com, you would just enter www.example.com
  • In the 'Application ID' field, cut and paste the 'Application id' value from the GitLab Application setup page.
  • In the 'Secret' field, cut and paste the 'Secret' value from the GitLab Application setup page.

When you're done click 'Yes, Continue'

On-Prem GitLab Connection

You’ll now be asked to log into your GitLab account (unless you are already logged in).

Login to GitLab

Finally, you will be asked to give Zapier permission to access your account. Click “Authorize” to continue.

Authorize GitLab on Zapier

If all steps were successful your GitLab account will now be successfully connected.

connection successful

Need More Help?

Contact Support

Tell us about your problem, and we’ll find you a solution or you can email support.
Get Help

Hire an Expert

We have a directory of professionals across the globe who are ready to help.
Find a Zapier Expert

Zapier Community

Connect with other Zapier users and industry professionals to get help crafting the perfect workflow.
Check out the community

Zapier University

Video courses designed to help you become a better Zapier user, whether you’re a beginner or more experienced.
View courses