Create a folder

POST/users/{uid}/folders/new

Creates a folder in the account of a member of your organisation, or in your own when uid is your account's ID. A folder created inside another takes on its members.

Request

curl -X POST 'https://api.measuremaponline.com/api/v1/users/m3K8qZxLpV4NrT2w/folders/new' \
  -H "Authorization: $MMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "2026 jobs",
  "description": "Everything quoted this year"
}'

Response

{
  "type": "folder",
  "id": "fld_8Jk2LmQ4",
  "creatorUid": "m3K8qZxLpV4NrT2w",
  "folderId": "",
  "name": "2026 jobs",
  "createdOn": 1788000000000,
  "description": "Everything quoted this year",
  "members": [
    "m3K8qZxLpV4NrT2w"
  ]
}

Path parameters

uidstringrequired
The ID of a member of your organisation, or your own account's ID.

Request body application/json

Fields of FolderCreate:

namestring
descriptionstring
parentIdstring
A folder to create it in; it takes on that folder's members.
membersarray of string
Accounts that can open the folder.

Responses

Folder:
- typestringrequired
  Always"folder"
- idstringrequired
- creatorUidstringrequired
  The account that owns the folder.
- folderIdstringor null
  The folder it is inside; empty or absent at the top level.
- namestringrequired
- descriptionstring
- createdOninteger(int64)required
  When it was created, in milliseconds since 1 January 1970 (UTC).
- membersarray of string
  The accounts that can open it and the projects filed in it.

Errors

A failed request answers with one of these, in an Error body.

400request_body_emptyThe request needs a JSON body and none was sent.

401unauthorized_actionThe item is not on your account or your members', the request came from a web page on a website the key does not allow, or the action is not allowed for this person.

403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.

403invalid_api_keyNo key was sent in the Authorization header, or the key is unknown, revoked, or past the time it kept working after being replaced.

Try it

API key

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

uid required

Body JSON

POST https://api.measuremaponline.com/api/v1/users/m3K8qZxLpV4NrT2w/folders/new

Fill in your API key to send.

As a cURL command

Shell

curl -X POST 'https://api.measuremaponline.com/api/v1/users/m3K8qZxLpV4NrT2w/folders/new' \
  -H "Authorization: $MMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "2026 jobs",
  "description": "Everything quoted this year"
}'