Great question—this is a super common pain point when building with the Figma API, especially since the default OAuth flow doesn’t explicitly hand you user or team details right out the gate. Let’s walk through exactly how to solve this:

1. Fetch the Authenticated User’s Profile (Including Teams) #

The key piece you’re missing is the GET /v1/me endpoint. This endpoint requires your OAuth-generated access token and returns the full profile of the user who authorized your app, including:

• Basic user info (ID, name, email)
• A teams array containing all teams the user is a member of, with each entry including the team’s ID and name.

To call it, include your access token in the Authorization header as a Bearer token:

// Example using fetch in JavaScript
const accessToken = "YOUR_OAUTH_ACCESS_TOKEN";

fetch("https://api.figma.com/v1/me", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${accessToken}`
  }
})
.then(res => res.json())
.then(userData => {
  // Access the user's teams
  const userTeams = userData.teams;
  console.log("User's teams:", userTeams);
  
  // Grab the first team ID to use in subsequent calls
  const firstTeamId = userTeams[0].id;
  getTeamProjects(firstTeamId);
});

2. Chain Calls to Get Projects and Files #

Once you have a team ID from the /me response, you can use the endpoints you already found, plus a few more, to drill down into projects and files:

• Get team projects: Use GET /v1/teams/{team_id}/projects to retrieve all projects under the team. Each project will have a project_id.
• Get project files: Use GET /v1/projects/{project_id}/files to list all files in a specific project.
• Get individual file details: Use GET /v1/files/{file_id} to fetch full details (pages, layers, etc.) for a single file.

3. Critical: Ensure You Request the Right OAuth Scopes #

None of these calls will work unless you requested the correct scopes during the OAuth authorization flow. Make sure you include:

• team_read: To access team data via /me and /teams/{team_id}/projects
• file_read: To fetch file details and project files

Your OAuth authorization URL should include these scopes, like:
https://www.figma.com/oauth?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=team_read%20file_read&response_type=code

4. Handling Personal Files (No Teams) #

If the user doesn’t belong to any teams and only has personal files, you can still access their content seamlessly. Figma automatically creates a "personal team" for every user, and this will show up in the teams array returned by the /me endpoint. You can use its ID to fetch personal projects and files just like any other team.

内容的提问来源于stack exchange，提问作者Julien Zmiro