# POST /spreadsheets

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

Create a new populated spreadsheet from a template. Starts with no rows. Optionally link to an opportunity.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `template_id` | body | uuid | yes | Template to base this spreadsheet on |
| `name` | body | string | yes | Spreadsheet name |
| `opportunity_id` | body | uuid | no | Link to an opportunity |

## Request example

```bash
{
  "template_id": "tmpl-uuid",
  "name": "Project Alpha Checklist",
  "opportunity_id": "deal-uuid"
}
```

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