Skip to main content
POST
Create a folder

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer yk_live_…. Scopes: transfers:read, transfers:write, collections:read, collections:write, contacts:read, contacts:write, webhooks:read, webhooks:write. A write scope implies read of the same resource.

Path Parameters

id
string
required

Collection id. Never a slug — see the Concepts page.

Body

application/json
name
string
required
Required string length: 1 - 200
parentId
string | null

Omit or null for the collection root.

Required string length: 1 - 64

Response

The new folder.

folder
object
required