figma-create-new-file

Original：🇺🇸 English

Translated

Create a new blank Figma file. Use when the user wants to create a new Figma design or FigJam file, or when you need a new file before calling use_figma. Handles plan resolution via whoami if needed. Usage — /figma-create-new-file [editorType] [fileName] (e.g. /figma-create-new-file figjam My Whiteboard)

3installs

Sourcefigma/mcp-server-guide

Added on2026-03-25

NPX Install

npx skill4agent add figma/mcp-server-guide figma-create-new-file

SKILL.md Content

View Translation Comparison →

create_new_file — Create a New Figma File

Use the

create_new_file

MCP tool to create a new blank Figma file in the user's drafts folder. This is typically used before

use_figma

when you need a fresh file to work with.

Skill Arguments

This skill accepts optional arguments:

/figma-create-new-file [editorType] [fileName]

editorType:
```
design
```
(default) or
```
figjam
```
fileName: Name for the new file (defaults to "Untitled")

Examples:

```
/figma-create-new-file
```
— creates a design file named "Untitled"
```
/figma-create-new-file figjam My Whiteboard
```
— creates a FigJam file named "My Whiteboard"
```
/figma-create-new-file design My New Design
```
— creates a design file named "My New Design"

Parse the arguments from the skill invocation. If editorType is not provided, default to

"design"

. If fileName is not provided, default to

"Untitled"

.

Workflow

Step 1: Resolve the planKey

The

create_new_file

tool requires a

planKey

parameter. Follow this decision tree:

User already provided a planKey (e.g. from a previous
```
whoami
```
call or in their prompt) → use it directly, skip to Step 2.
No planKey available → call the
```
whoami
```
tool. The response contains a
```
plans
```
array. Each plan has a
```
key
```
,
```
name
```
,
```
seat
```
, and
```
tier
```
.
- Single plan: use its
```
key
```
  field automatically.
- Multiple plans: ask the user which team or organization they want to create the file in, then use the corresponding plan's
```
key
```
  .

Step 2: Call create_new_file

Call the

create_new_file

tool with:

Parameter	Required	Description
`planKey`	Yes	The plan key from Step 1
`fileName`	Yes	Name for the new file
`editorType`	Yes	`"design"` or `"figjam"`

Example:

json

{
  "planKey": "team:123456",
  "fileName": "My New Design",
  "editorType": "design"
}

Step 3: Use the result

The tool returns:

```
file_key
```
— the key of the newly created file
```
file_url
```
— a direct URL to open the file in Figma