# Create a folder (optionally with leads in it)

> POST /crm/folders. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/crm/post-crm-folders-create-a-folder-optionally-with-leads-in-it

POST https://server.heyrik.com/api/v1/crm/folders

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- name (string, required): Folder name.
- color (string): Hex colour for the dashboard.
- leadIds (array): Leads to move into it right away.

## Notes

A folder can be turned into a campaign from the dashboard, or dial its leads with POST /leads/call.

## Request example

```sh
curl -X POST https://server.heyrik.com/api/v1/crm/folders \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Hyderabad - August", "leadIds": ["lead_71a4"] }'
```