This guide will walk you through the process of creating and managing integrations on Vercel, helping you to extend the capabilities of your Vercel projects by connecting with third-party services.
Integrations can be created by filling out the Create Integration form. To access the form:
- From your Vercel dashboard, select your account/team from the scope selector
- Select the Integrations tab to see the Integrations overview
- Then, select the Integrations Console button and then select Create
- Fill out all the entries in the Create integration form as necessary
- At the end of the form, you must accept Vercel's Integration Marketplace Agreement in order for your integration to be published
The Create Integration form must be completed in full before you can submit your integration for review. The form has the following fields:
The name of your integration.
The URL slug for your integration.
The owner of the Integration, generally a legal name.
The contact email for the owner of the integration. This will not be publicly listed.
The support email for the integration. This will be publicly listed.
A short description of your integration.
The logo for your integration.
The category for your integration.
The website for your integration.
The documentation URL for your integration.
The URL to your End User License Agreement (EULA) for your integration.
A detailed overview of your integration.
Additional information about configuring your integration.
A featured image or video for your integration. You can link up to 5 images or videos for your integration with the aspect ratio of 3:2.
The URL to redirect the user after installation.
The API scopes for your integration.
The URL to receive webhooks from Vercel.
The URL to configure your integration.
The agreement to the Vercel Integrations Marketplace Agreement
Once you have created your integration, it will be assigned the Community badge and be available for external users to download. You can share it with users either through your site or through the Vercel deploy button.
If you are interested in having your integration listed on the Integration Marketplace:
- The integration must have at least 500 active installs.
- Once you've reached this minimum install requirement, please email email@example.com with your request to be reviewed for listing.
You can view all integrations that you have created on the Integrations Console.
To preview an integration's live URL, click View Integration. This URL can be shared for installation based on the integration's visibility settings.
The live URL has the following format:
<slug> is the name you specified in the URL Slug field during the integration creation process.
In the Integrations Console, a Community badge will appear under your new integration's title once you have submitted the integration. While integrations with a Community badge do not appear in the marketplace, they are available to be installed through your site or through the Vercel deploy button
The installation of the integration is a critical component of the developer experience that must cater to all types of developers. While deciding the installation flow you should consider the following:
- New user flow: Developers should be able to create an account on your service while installing the integration
- Existing user flow: With existing accounts, developers should sign in as they install the integration. Also, make sure the forgotten password flow doesn't break the installation flow
- Strong defaults: The installation flow should have minimal steps and have set defaults whenever possible
- Advanced settings: Provide developers with the ability to override or expand settings when installing the integration
For the installation flow, you should consider adding the following specs:
Explain the integration and how to use it. Also explain the defaults and how to override them.
Create a Deploy Button for projects based on a Git repository.
As an integration creator, you are solely responsible for the support of your integration developed and listed on Vercel. When providing user support, your response times and the scope of support must be the same or exceed the level of Vercel's support. For more information, refer to the Vercel Integrations Marketplace Agreement.
When submitting an integration, you'll enter a support email, which will be listed publicly. It's through this email that integration users will be able to reach out to you.