Skip to content

Integration Permissions

Learn more about granting access to API endpoints with integration permissions

Integration permissions restrict the API surface the integration is allowed to access. When you install an integration, you will see an overview of what permissions the integration requires to work.

Note: If you are building an integration, see the scopes documentation for integrators to learn more about the relationship between scopes and endpoints.
Permission Type
Read Access
Write Access
Installation
Reads whether the integration is installed for the hobby or team account
Removes the installation for the hobby or team account
Deployment
Retrieves deployments for the hobby or team account. Includes build logs, a list of files and builds, and the file structure for a specific deployment
Creates, updates, and deletes deployments for the hobby or team account
Deployment Checks
N/A
Retrieves, creates, and updates tests/assertions that trigger after deployments for the hobby or team account
Project
Retrieves projects for the hobby or team account. Also includes retrieving all domains for an individual project
Creates, updates, and deletes projects for the hobby or team account
Project Environment Variables
N/A
Reads, creates, and updates integration-owned environment variables for the hobby or team account
Global Project Environment Variables
N/A
Reads, creates, and updates all environment variables for the hobby or team account
Team
Accesses team details for the account. Includes listing team members
N/A
Current User
Accesses information about the hobby account on which the integration is installed
N/A
Log Drains
N/A
Retrieves a list of log drains, creates new and removes existing ones for the hobby or team account
Domain
Retrieves all domains for the hobby or team account. Includes reading its status and configuration
Removes a previously registered domain name from Vercel for the hobby or team account

Integrations can request more permissions over time. Individual users and team owners will get notified if an integration installation has pending permission changes, and will also see a pending review indicator on the Vercel Dashboard.

Changed Permissions on Integration.

The user or team can review and approve every permission change. Every permission request will contain a note from the integrator with further details on why this change is necessary. Confirming permission changes ensures that the integration has the right access and can use upcoming and new features of the Vercel platform to support your daily work.

Review Permission changes.