Skip to main content
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.

​
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 with the team that will own the integration.

  • Click Create Integration.
Integrations Console with the Create Integration button highlighted
2

Fill in the profile

Complete the Profile section of the form.

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

  • 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.
API Scopes list with the Read and Read/Write selections highlighted
5

Create the integration

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

  • Under Integration Agreement, select I accept.
  • Click Create.
Visibility section with Unlisted selected and its direct-link note highlighted
6

Copy credentials

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

  • Under Access Details, copy the Client (Integration) ID to Client ID in your Connector Profile.
  • Copy the Client (Integration) Secret to Client Secret in your Connector Profile.
Access Details with the copy buttons for the Client (Integration) ID and Secret highlighted

​
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.
2

Link an Account

Once the Connector Profile is created, continue to link an account.