Skip to main content
POST
/
folder
Create folder
curl --request POST \
  --url https://api.h0p.co/folder \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Marketing Campaign 2024",
  "color": "#3B82F6"
}
'
{
  "id": "01933eb8-541f-7000-a9f4-e4eee80ff04e",
  "organizationId": "01933eb8-541f-7000-a9f4-e4eee80ff04e",
  "name": "Marketing Campaign 2024",
  "color": "#3B82F6",
  "isDefault": false,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-16T14:20:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.h0p.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

API Key authentication for programmatic access.

How to use:

  1. Create an API key from your dashboard settings
  2. Include the key in the x-api-key header with each request
  3. API keys have granular permissions (domains, shortLinks, files, stats, apiKeys)

Example:

curl -H "x-api-key: your-api-key-here" https://api.h0p.co/short-link/list

Types of API keys:

  • User keys: Linked to your user account (one per organization)
  • Bot keys: Autonomous machine users (one per organization)

Security notes:

  • Keep your API keys secure and never commit them to version control
  • API keys cannot access authentication endpoints (/auth/*)
  • Keys can be revoked at any time from the dashboard

Body

application/json

Folder name and optional color

Folder creation request

​
name
string
required

Folder name

Required string length: 1 - 30
Example:

"Marketing Campaign 2024"

​
color
string

Folder color (hex)

Pattern: ^#[0-9A-Fa-f]{6}$
Example:

"#3B82F6"

Response

Folder successfully retrieved

Complete folder object

​
id
string<uuid>
required

Folder UUID

Example:

"01933eb8-541f-7000-a9f4-e4eee80ff04e"

​
organizationId
string<uuid>
required

Organization UUID

Example:

"01933eb8-541f-7000-a9f4-e4eee80ff04e"

​
name
string
required

Folder name

Required string length: 1 - 30
Example:

"Marketing Campaign 2024"

​
color
string | null
required

Folder color (hex)

Pattern: ^#[0-9A-Fa-f]{6}$
Example:

"#3B82F6"

​
isDefault
boolean
required

Whether this is the default "Links" folder

Example:

false

​
createdAt
string<date-time>
required

Creation timestamp

Example:

"2024-01-15T10:30:00Z"

​
updatedAt
string<date-time>
required

Last update timestamp

Example:

"2024-01-16T14:20:00Z"