Vercel
Connect Vercel to deploy and manage websites from affiliateOS.
The Vercel integration connects an affiliateOS organization to a Vercel account or team. It creates hosting projects for connected websites, uploads deployments, manages project configuration, and checks domain and deployment status.
Before you connect
You need permission to manage integrations in your affiliateOS organization and authority to install the integration in the target Vercel account or team.
Hosting resources belong to the connected Vercel account or team. Its plan, usage limits, and charges apply.
Connect Vercel
- Open your organization in affiliateOS.
- Go to Settings → Integrations.
- Select Connect with Vercel.
- In Vercel, choose the account or team that should host your websites.
- Review the requested permissions and grant access to all projects so affiliateOS can create new website projects.
- Complete the installation and return to affiliateOS.
- Confirm that the connection shows the expected Vercel account or team before binding a website.
Permissions
| Resource | Access | Purpose |
|---|---|---|
| Projects | Read and write | Create a project for a bound website and delete it when unbinding |
| Deployments | Read and write | Upload website files, create deployments, and read their status |
| Project environment variables | Read and write | Configure the website credential and content endpoint |
| Domains | Read and write | Add, inspect, verify, and remove custom domains |
| User and team | Read | Identify the account or team and label the connection |
| Integration configuration | Read | Inspect the installation |
The integration also configures preview protection and creates access secrets for automated preview checks. The connection credential is stored encrypted by affiliateOS.
Reconnect
If the installation is removed or the granting user loses access to the Vercel team, the connection may be marked Revoked after its next status check. Select Reconnect and authorize the connection again for the intended account or team.
Disconnect
Select Disconnect in affiliateOS to disable the connection and remove its stored credential. You can also remove the installation from the Vercel dashboard.
Disconnecting does not delete existing Vercel projects, deployments, or domains. Manage those resources and any ongoing charges in Vercel separately.
Troubleshooting
The connect button is missing
Ask your instance operator to confirm that the Vercel OAuth integration is configured. The connect button is hidden when that configuration is unavailable.
A project cannot be created
Check that you selected the intended account or team, granted all-project access, and have sufficient Vercel permissions and plan capacity.
A domain is not verified
Review the domain's required DNS records and verification status. Update the records with your DNS provider, then check the domain again after the changes have propagated.