--- title: Vercel API Integration on Truto slug: vercel category: Default canonical: "https://truto.one/integrations/detail/vercel/" --- # Vercel API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ## How it works 1. **Link your customer's Vercel account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Vercel.** The Proxy API is a 1-to-1 mapping of the Vercel API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync Vercel team structures into your SaaS tenant model** — Map your customers' Vercel Teams, members, and roles directly into your product's workspace model using Truto's Unified User Directory API. This lets you automatically align permissions, seats, and access controls without asking users to manually configure team mappings. - **Auto-provision user accounts from Vercel team membership** — When your customer connects their Vercel account, automatically discover all team members and their roles to pre-populate your product's user directory. This eliminates manual onboarding friction and ensures your SaaS reflects the customer's actual org structure from day one. - **Enforce role-based access controls mirroring Vercel permissions** — Pull Vercel roles and group memberships into your product to enforce consistent access policies. A platform engineer with an 'Owner' role in Vercel can automatically receive admin-level permissions in your SaaS, reducing misconfiguration risk. - **Offer native Vercel connectivity for developer-facing SaaS products** — If your product serves developers or DevOps teams, offering a one-click Vercel integration signals first-class support for their deployment workflow. Truto handles the OAuth flow, token management, and API abstraction so your team can ship the integration in days instead of weeks. ## What you can build - **Automatic team and workspace discovery** — On connection, pull all Vercel Teams as Workspaces into your product so customers can select which team context to operate in. - **Real-time member roster sync** — Continuously sync Vercel team members into your user directory, detecting new additions, removals, and role changes without manual intervention. - **Role-mapped permission provisioning** — Translate Vercel roles (Owner, Member, Viewer) into your product's permission tiers so access controls stay aligned across both platforms. - **Group-based feature gating** — Use Vercel group memberships surfaced through the Unified User Directory API to control which user segments can access specific features in your product. - **Unified org chart across multiple integrations** — Combine Vercel user directory data with other connected platforms via Truto's Unified User Directory API to give customers a single, consolidated view of their organization's members and roles. ## FAQs ### What authentication method does the Vercel integration use? Vercel supports OAuth 2.0 for third-party integrations. Truto manages the full OAuth flow, token storage, and automatic refresh so your team never handles raw credentials. ### What data can I access through Truto's Unified User Directory API for Vercel? You can access Users (team members), Groups, Roles, and Workspaces (mapped from Vercel Teams). This covers team membership, permission levels, and organizational structure. ### Are there specific Truto tools available for Vercel's deployment or environment variable APIs? Not yet. Truto currently maps Vercel to the Unified User Directory API. Additional tools for deployments, environment variables, log drains, and other Vercel API capabilities are built on request based on your use case. ### How does Truto handle Vercel's API rate limits? Truto automatically manages rate limiting, retry logic, and pagination when calling the Vercel API, so your application doesn't need to implement backoff strategies or handle HTTP 429 responses directly. ### Can I request custom Vercel API capabilities beyond the Unified User Directory? Yes. Vercel exposes a rich REST API covering deployments, projects, environment variables, log drains, and more. Truto builds additional tools on request — reach out with your specific use case and the team will scope the integration. ### How are Vercel Teams mapped in Truto's unified model? Vercel Teams map to Workspaces in Truto's Unified User Directory API. Team members map to Users, and Vercel's permission levels (Owner, Member, Viewer, Developer) map to Roles, giving you a normalized structure consistent across all integrations.