Create a collection

POST

/collections

POST

/collections

$ curl -X POST "https://api.postman.com/collections?workspace=1f0df51a-8658-4ee8-a2a1-d2567dfa09a9" \
>      -H "x-api-key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "collection": {
>     "info": {
>       "name": "Test Collection",
>       "schema": "https://schema.postman.com/json/collection/v2.1.0/collection.json",
>       "description": "This collection makes a request to the Postman Echo service to get a list of request headers sent by an HTTP client."
>     },
>     "item": [
>       {
>         "name": "Test GET Response",
>         "event": [
>           {
>             "listen": "test",
>             "script": {
>               "type": "text/javascript",
>               "exec": [
>                 "pm.test(\"Status code is 200\", function () {",
>                 "    pm.response.to.have.status(200);",
>                 "});"
>               ],
>               "id": "7d2334fc-a84a-4c3d-b26c-7529afa4c0ae"
>             }
>           }
>         ],
>         "request": {
>           "url": "https://echo.postman.com/headers",
>           "method": "GET",
>           "header": [
>             {
>               "key": "Content-Type",
>               "value": "application/json"
>             }
>           ]
>         }
>       }
>     ],
>     "variable": [
>       {
>         "key": "userId",
>         "value": "12345678",
>         "description": "The user'\''s ID.",
>         "disabled": true
>       }
>     ]
>   }
> }'

1 {
2   "collection": {
3     "id": "12ece9e1-2abf-4edc-8e34-de66e74114d2",
4     "name": "Test Collection",
5     "uid": "12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2"
6   }
7 }

Creates a collection using the Postman Collection v2.1.0 schema format.

Note:

If you do not include the workspace query parameter, the system creates the collection in the oldest personal Internal workspace you own.

Creates a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** If you do not include the `workspace` query parameter, the system creates the collection in the oldest personal Internal workspace you own.

Authentication

x-api-keystring

API Key authentication via header

Query parameters

workspacestringRequired

The workspace's ID.

Request

This endpoint expects an object.

collectionobjectOptional

Information about the collection.

Response

Successful Response

collectionobjectOptional

Information about the created collection.

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

500

Internal Server Error