> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Portfolio

> Create a folder of trademark records

<Snippet file="portfolios/access.mdx" />

See [portfolio limits and references](/guides/portfolios) for current caps and
`external_ref` semantics.

## Overview

A portfolio groups Signa trademark records into a customer-owned folder. It does
not create matters, tasks, or completion state. New portfolios start empty; use
[Add Trademarks](/api-reference/portfolios/add-trademarks) to populate them.

## Request

Send a unique `name` (1–255 characters), optional `description` (up to 2,000
characters), and optional string-valued `metadata` (up to 50 keys). Requires an
`Idempotency-Key` header.

## Response

The created portfolio at the top level, with a `ptf_` ID and HTTP 201.

## Errors

The portfolio-count limit is separate from the managed-marks allowance: free 3,
beta 20, starter 10, pro 50, enterprise unlimited. Exceeding it returns
409 `resource_quota_exceeded` with `quota_scope: "portfolios"`. A duplicate name
returns 409 `conflict`.