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

# Vercel OAuth 2.0 (Vercel Integration) connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 (Vercel Integration) for Vercel in StackOne to allow users to link their accounts.

> [!WARNING]
>
> Integration scopes cover projects, environment variables, deployments, Global Config, domains and team and user reads, plus billing and drains on Pro and Enterprise teams. Actions outside these scopes are not available with this connection type.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create the Vercel Integration

A Vercel Integration belongs to the team that creates it. Its API scopes decide what each linked account can read and change.

**1. Start the integration**

Sign in to the [Vercel Integrations Console](https://vercel.com/dashboard/integrations/console) with the team that will own the integration.

<ul>
  <li>Click **Create Integration**.</li>
</ul>

![Integrations Console with the Create Integration button highlighted](https://mintcdn.com/stackone-60/oF1LBi7NvgsJMv1D/connectors/vercel/images/integration_oauth2-setup-create-integration.png?fit=max\&auto=format\&n=oF1LBi7NvgsJMv1D\&q=85\&s=306af1aab02fa6c3fbb0bad63a754f42)

**2. Fill in the profile**

Complete the **Profile** section of the form.

<ul>
  <li>**Name**: A unique name for the integration, such as `StackOne Integration`</li>
  <li>**Logo**: Your logo</li>
  <li>**Category**: The category that fits your product</li>
  <li>**Short Description**: Short summary of the integration</li>
  <li>**URL Slug**: A unique slug, such as `stackone-integration`</li>
  <li>Copy the **URL Slug** to **Integration URL Slug** in your Connector Profile.</li>
  <li>Format: the part after `vercel.com/integrations/`</li>
  <li>Example: `stackone-integration`</li>
  <li>**Developer**: Your company's legal name</li>
  <li>**Contact Email**: Email address of the integration owner</li>
  <li>Optionally, select **Use the same contact information for support inquiries**.</li>
  <li>**Website**, **Documentation URL**, **EULA URL**, **Privacy Policy URL** and **Support URL**: Links to your own pages</li>
  <li>**Overview**: Short description of what the integration does</li>
  <li>**Featured Images**: At least one image of your product</li>
</ul>

![Create Integration form with the URL Slug, Developer and Contact Email fields highlighted](https://mintcdn.com/stackone-60/oF1LBi7NvgsJMv1D/connectors/vercel/images/integration_oauth2-setup-profile.png?fit=max\&auto=format\&n=oF1LBi7NvgsJMv1D\&q=85\&s=abea0d4305a8c2fdbf80d00b78f0b0e7)

**3. Set the redirect URL**

Under **Settings**, in **Redirect URL**, enter the **Callback URL** from your Connector Profile.

![Settings section with the Redirect URL field highlighted](https://mintcdn.com/stackone-60/oF1LBi7NvgsJMv1D/connectors/vercel/images/integration_oauth2-setup-redirect-url.png?fit=max\&auto=format\&n=oF1LBi7NvgsJMv1D\&q=85\&s=e78fae8ec571fe378e2ec8eefbad5669)

**4. Choose the API scopes**

Enables actions: Add Project Domain, Batch Remove Project Env, Buy Single Domain, Cancel Deployment, Create DNS Record, Create Deployment, Create Drain, Create Edge Config, Create Edge Config Token, Create Project, Create Project Env, Delete Configuration, Delete DNS Record, Delete Deployment, Delete Domain, Delete Drain, Delete Edge Config, Delete Edge Config Tokens, Delete Project, Edit Project Env, Filter Project Envs, Get Cert, Get Configuration, Get Current User, Get Deployment, Get Deployment Events, Get Deployment File Contents, Get Domain, Get Domain Availability, Get Domain Config, Get Domain Price, Get Drain, Get Drains, Get Edge Config, Get Edge Config Item, Get Edge Config Items, Get Edge Config Token, Get Edge Config Tokens, Get Project, Get Project Domain, Get Project Domains, Get Project Env, Get Team, Get Unified Credentials, Get Unified Organization, Get Unified Role, Get Unified User, Issue Cert, List Billing Charges, List Contract Commitments, List DNS Records, List Deployment Aliases, List Deployment Files, List Deployments, List Domains, List Edge Configs, List Projects, List Team Members, List Unified Roles, List Unified Users, Patch Edge Config Items, Remove Cert, Remove Project Domain, Remove Project Env, Test Drain, Update DNS Record, Update Drain, Update Edge Config, Update Project, Update Project Domain, Upload Cert, Upload File, Verify Project Domain

Under **API Scopes**, set each scope listed to **Read** or **Read/Write** to match its suffix. Where both appear, choose **Read/Write**.

<ul>
  <li>**Billing** and **Drains** are under **Scopes exclusively available to Pro and Enterprise teams**. Leave them at **None** unless every team that connects is on Pro or Enterprise.</li>
</ul>

![API Scopes list with the Read and Read/Write selections highlighted](https://mintcdn.com/stackone-60/oF1LBi7NvgsJMv1D/connectors/vercel/images/integration_oauth2-setup-api-scopes.png?fit=max\&auto=format\&n=oF1LBi7NvgsJMv1D\&q=85\&s=6bc947c5f227b5ed4e6e88f41d66c886)

<ul>
  <li>
    project:read
  </li>

  <li>
    project:read-write
  </li>

  <li>
    deployment:read
  </li>

  <li>
    deployment:read-write
  </li>

  <li>
    global-project-env-vars:read-write
  </li>

  <li>
    domain:read
  </li>

  <li>
    domain:read-write
  </li>

  <li>
    global-config:read-write
  </li>

  <li>
    team:read
  </li>

  <li>
    user:read
  </li>

  <li>
    integration-configuration:read
  </li>

  <li>
    integration-configuration:read-write
  </li>

  <li>
    billing:read
  </li>

  <li>
    drains:read-write
  </li>
</ul>

**5. Create the integration**

Under **Visibility**, select **Unlisted** so any team can install the integration from the link StackOne opens, without a Marketplace listing.

<ul>
  <li>Under **Integration Agreement**, select **I accept**.</li>
  <li>Click **Create**.</li>
</ul>

![Visibility section with Unlisted selected and its direct-link note highlighted](https://mintcdn.com/stackone-60/oF1LBi7NvgsJMv1D/connectors/vercel/images/integration_oauth2-setup-visibility.png?fit=max\&auto=format\&n=oF1LBi7NvgsJMv1D\&q=85\&s=14cd2eb150943e64beab8d64b416bec5)

**6. Copy credentials**

In the **Integrations Console**, click **Manage** next to the integration.

<ul>
  <li>Under **Access Details**, copy the **Client (Integration) ID** to **Client ID** in your Connector Profile.</li>
  <li>Copy the **Client (Integration) Secret** to **Client Secret** in your Connector Profile.</li>
</ul>

![Access Details with the copy buttons for the Client (Integration) ID and Secret highlighted](https://mintcdn.com/stackone-60/oF1LBi7NvgsJMv1D/connectors/vercel/images/integration_oauth2-setup-credentials.png?fit=max\&auto=format\&n=oF1LBi7NvgsJMv1D\&q=85\&s=9e7f52d8f330174f4e20642db8f0147a)

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/vercel/guides/link-account/oauth-2-0-vercel-integration.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.