Connect Vercel to iter0

When iter0 proposes a change to your site, it opens a pull request in your GitHub repository. Once Vercel is connected, iter0 can look at the Vercel project that builds that repository and check that Vercel built the pull request's exact commit as a Preview. It then reports the result in iter0.

iter0 only reads from Vercel. It does not merge the pull request, deploy anything or change settings in your Vercel account. It also does not accept a production deployment as proof that a preview worked.

• An iter0 account and a project in it. Each iter0 project has its own connection.
• The project's GitHub repository, connected to iter0. Vercel can be connected only after GitHub.
• A Vercel project that builds from that same GitHub repository. iter0 lists only the Vercel projects linked to the repository you connected.

1. In the builder's left sidebar, open Connections.
2. Under Choose a project, pick the iter0 project you want to connect.
3. Choose Connect GitHub and select the repository. If the iter0 GitHub App is already installed on your GitHub account, choose Use existing GitHub installation instead.
4. On the Connect Vercel card, choose Connect Vercel. The button stays off until GitHub is connected, and the card says Connect GitHub first.
5. Your browser goes to Vercel. Vercel asks which team to install iter0 on and which of its projects iter0 may read. Allow the project that builds your site.
6. Back in iter0, the card lists the Vercel projects linked to your connected GitHub repository. Choose the project that builds your site.
7. The card now shows the Vercel project ID and team ID, and a Disconnect in iter0 button.

Start and finish in the same browser. iter0 keeps the connection open for 10 minutes after you choose Connect Vercel. After that, start again.

The integration has three permissions, all set to Read. Every other Vercel permission is set to None, so iter0 cannot see your environment variables, domains, billing or team members, and it cannot change anything.

iter0 stores one access token for each connection, encrypted. It deletes the token when you disconnect in iter0. It also deletes the token when Vercel tells iter0 that you uninstalled the integration. If you uninstall while you are still choosing a project, iter0 checks again before it saves the connection and does not save it if Vercel reports the installation gone. If the connection still shows as connected after you uninstall, choose Disconnect in iter0 to delete the token yourself.

iter0 also keeps a record of the connection: the Vercel team ID, project ID and installation ID, and the GitHub repository it is linked to. For each preview check it keeps the deployment ID, preview address, commit and status. Disconnecting or uninstalling does not delete these records. They stay with your iter0 project with no automatic expiry, and deleting your iter0 account removes them. The privacy policy covers retention in full.

Disconnecting and uninstalling are two separate actions in two places. Either one ends iter0's access to your Vercel project.

• Disconnect in iter0. Open Connections, choose the project, and choose Disconnect in iter0 on the Connect Vercel card. iter0 deletes the stored token and stops reading your Vercel project. The integration stays installed in Vercel.
• Uninstall in Vercel. In Vercel, open Integrations, find iter0 and choose Manage, then Settings, then Uninstall Integration. Vercel tells iter0, and iter0 revokes the connection and deletes the stored token. The Connect Vercel card then reads Disconnected in iter0.

• The Connect Vercel button is off and the card says Connect GitHub first. GitHub is not connected for the selected project. Connect GitHub, then return to this card.
• The card says The connection wasn't completed. Try connecting again when you're ready. The return from Vercel did not finish. This happens when you close Vercel before approving, when more than 10 minutes pass, or when you finish in a different browser from the one you started in. Choose Connect Vercel and go through it again in one sitting.
• The card says Finish authorization in Vercel to choose a project. iter0 is still waiting for your approval in Vercel. Choose Restart Vercel connection, or Cancel to stop.
• The card says No matching project on this page. Check project access or load more. Your Vercel project is not on this page of results, or it is not linked to the connected GitHub repository. Choose Load more projects. If the project is still missing, check in Vercel that its Git connection points at the same repository and that you allowed iter0 to read it, then choose Restart Vercel connection.
• The card says Your hosting connection couldn't be checked or This project couldn't be connected. Choose Refresh connection and pick the project again.
• The card says Hosting isn't set up yet. The problem is on iter0's side, so contact us.
• The card says Disconnected in iter0 after you uninstalled the integration in Vercel. That is expected. Choose Connect Vercel to connect again.

If none of these match, use the support details on the iter0 contact page. Send your Vercel team name, your iter0 project and the exact message the card shows. Do not send access tokens or passwords.