# POST /notepads

**Resource:** [Notepads](./notepads.md)  
**Scopes:** `notepads:write`  
**Write operation:** yes

Create a notepad. Content accepts plain text or markdown (auto-converted to rich editor format) or a { html, tiptapJson } object. Defaults to visibility="all_users" -- pass "restricted" to restrict access. For "restricted" notes, add ACL entries via POST /notepads/:id/acl. Pass customer_id or contact_id to automatically link the notepad to a Company or Contact page (appends its ID to that entity's notepads array). folder_id and folder string are synced bidirectionally -- set either one and the other is auto-populated. Response is slim by default (id, title, folder, folder_id, visibility, is_favorite, timestamps) -- pass return_content: true to receive the full rendered HTML.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `title` | body | string | yes | Notepad title |
| `content` | body | string | no | Content as plain text/markdown (auto-converted) or { html, tiptapJson } object |
| `folder_id` | body | uuid | no | Folder UUID (preferred over folder name). Auto-populates the folder string field. |
| `folder` | body | string | no | Folder name (resolved to existing folder or created if missing). Auto-populates folder_id. |
| `visibility` | body | string | no | all_users (default) or restricted |
| `is_favorite` | body | boolean | no | Mark as favourite |
| `customer_id` | body | uuid | no | Company/account UUID. The new notepad is automatically linked to this company -- its ID is appended to the company notepads array. Makes the note appear in the Notepads section of the company page. |
| `contact_id` | body | uuid | no | Contact UUID. The new notepad is automatically linked to this contact -- its ID is appended to the contact notepads array. Makes the note appear in the Notepads section of the contact page. |
| `return_content` | body | boolean | no | Set true to include full rendered HTML in response. Default false. |

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`