Create a collection

POST

/collections

POST

/collections

$ curl -X POST "https://api.getpostman.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.getpostman.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.getpostman.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

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Query parameters

workspacestringRequired

The workspace's ID.

Request

This endpoint expects an object.

collectionobjectOptional

Response

Successful Response

collectionobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error