Skip to main content
POST
/
contacts
/
folders
Create Contact Folder
curl --request POST \
  --url https://api.truedy.ai/api/public/v1/contacts/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "VIP Leads",
  "description": "High-priority leads for Q2 campaign"
}
'
{
  "data": {
    "id": "folder_abc123",
    "name": "VIP Leads",
    "description": "High-priority leads for Q2 campaign",
    "contact_count": 0,
    "created_at": "2026-04-05T10:22:00Z"
  },
  "meta": {
    "request_id": "req_32e7531c",
    "ts": "2026-04-05T10:22:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header: Bearer <your_api_key>

Body

application/json
​
name
string
required

Folder display name

Example:

"VIP Leads"

​
description
string | null

Optional description

Example:

"High-priority leads for Q2 campaign"

Response

Folder created