> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get started with Box Notes API
> Set up authentication and create your first Box Note from Markdown content.
export const RelatedLinks = ({title, items = []}) => {
const getBadgeClass = badge => {
if (!badge) return "badge-default";
const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
};
if (!items || items.length === 0) {
return null;
}
return
;
};
export const Link = ({href, children, className, ...props}) => {
const localizedHref = href;
return
{children}
;
};
This guide walks you through creating your first Box Note from
Markdown using the Box Notes API. By the end, you have a
`.boxnote` file in your Box account created from a single API call.
## Prerequisites
Before you begin, make sure you have:
* A Box account with file upload permissions.
* A platform application configured in the Box Developer Console.
* A valid access token for authentication (OAuth 2.0 or JWT).
* A target folder ID in Box where you want to create the note.
The Box Notes API requires API version `2026.0`. All requests must
include the `box-version: 2026.0` header.
## Step 1: Generate an access token
You need an access token to authenticate your API calls.
To generate a developer token for testing:
1. Go to **Developer Console** > **My Platform Apps**.
2. Click the **Options menu** button (**…**) next to your app.
3. Select **Generate Developer Token**. The token is automatically
copied to your clipboard.
Developer tokens expire after one hour. For production use, implement
OAuth 2.0 or
JWT authentication.
## Step 2: Identify your target folder
You need the folder ID where the new note has been created. To find a
folder ID:
* Open the folder in the Box web app. The folder ID is the number at
the end of the URL: `https://app.box.com/folder/123456789`.
* Alternatively, use the Get
folder API endpoint.
Use `0` as the folder ID to create the note in the root folder
(All Files).
## Step 3: Create your first Box Note
Send a `POST` request to the `/2.0/notes/convert` endpoint with your
Markdown content. The API converts the Markdown to a Box Note and
uploads it to the specified folder.
```sh cURL theme={null}
curl -L 'https://api.box.com/2.0/notes/convert' \
-H 'box-version: 2026.0' \
-H 'Authorization: Bearer ' \
-H 'Content-Type: application/json' \
-d '{
"content": "# Welcome\n\nThis is my first **Box Note** created using the API.",
"content_format": "markdown",
"parent": {
"id": "123456789"
},
"name": "My First Note"
}'
```
```python Python theme={null}
import requests
url = "https://api.box.com/2.0/notes/convert"
headers = {
"box-version": "2026.0",
"Authorization": "Bearer ",
"Content-Type": "application/json",
}
payload = {
"content": "# Welcome\n\nThis is my first **Box Note** created using the API.",
"content_format": "markdown",
"parent": {"id": "123456789"},
"name": "My First Note",
}
response = requests.post(url, json=payload, headers=headers)
print(response.status_code, response.json())
```
```javascript Node.js theme={null}
const response = await fetch("https://api.box.com/2.0/notes/convert", {
method: "POST",
headers: {
"box-version": "2026.0",
Authorization: "Bearer ",
"Content-Type": "application/json",
},
body: JSON.stringify({
content:
"# Welcome\n\nThis is my first **Box Note** created using the API.",
content_format: "markdown",
parent: { id: "123456789" },
name: "My First Note",
}),
});
const data = await response.json();
console.log(data);
```
A successful request returns `201 Created` with the new file's
information:
```json theme={null}
{
"type": "file",
"id": "1234567890"
}
```
## Step 4: Verify the note was created
Use the returned `id` to retrieve the full file metadata from the
Box Files API:
```sh theme={null}
curl -L 'https://api.box.com/2.0/files/1234567890' \
-H 'Authorization: Bearer '
```
You can also open the Box web app and navigate to the target folder
to confirm the `.boxnote` file appears.
## Next steps
Now that you have created your first Box Note, explore these guides: