Postman

Official

Overview Schema Source Related Servers Discussions Admin

Create a collection

createCollection

Creates a collection in a specified workspace using the Postman Collection v2.1.0 schema, so teams can organize and reuse API requests.

Instructions

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`workspace`	Yes	The workspace's ID.
`collection`	No	Information about the collection.

Schema Changelog

Changes observed during successful MCP inspections.

Changed12 schema fields changedv2.14.0Oct 21, 2026

changedInput schema / properties / collection / properties / item / items / properties / item / items / additionalProperties
```
Previous value: -falseNew value: +{}
```

addedInput schema / properties / collection / properties / item / items / properties / item / items / properties / event

Added value: +{
+  "description": "A list of scripts configured to run when specific events occur. Include this on requests inside folders to keep their pre-request (`prerequest`) and post-response (`test`) scripts — scripts you omit here are not carried over from the stored item.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "description": "The event's ID.",
+        "type": "string"
+      },
+      "listen": {
+        "description": "The `prerequest` (pre-request) or `test` (post-response) value.",
+        "enum": [
+          "test",
+          "prerequest"
+        ],
+        "type": "string"
+      },
+      "script": {
+        "additionalProperties": false,
+        "description": "Information about the Javascript code that runs when the event fires.",
+        "properties": {
+          "exec": {
+            "description": "A list of script strings, where each line represents a line of code.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "id": {
+            "description": "The script's ID.",
+            "type": "string"
+          },
+          "type": {
+            "description": "The type of script. For example, `text/javascript`.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "listen"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedInput schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / additionalProperties
```
Previous value: -falseNew value: +{}
```

added

Input schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / properties / event

Added value: +{
+  "description": "A list of scripts configured to run when specific events occur. Include this on requests inside folders to keep their pre-request (`prerequest`) and post-response (`test`) scripts — scripts you omit here are not carried over from the stored item.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "description": "The event's ID.",
+        "type": "string"
+      },
+      "listen": {
+        "description": "The `prerequest` (pre-request) or `test` (post-response) value.",
+        "enum": [
+          "test",
+          "prerequest"
+        ],
+        "type": "string"
+      },
+      "script": {
+        "additionalProperties": false,
+        "description": "Information about the Javascript code that runs when the event fires.",
+        "properties": {
+          "exec": {
+            "description": "A list of script strings, where each line represents a line of code.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "id": {
+            "description": "The script's ID.",
+            "type": "string"
+          },
+          "type": {
+            "description": "The type of script. For example, `text/javascript`.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "listen"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedInput schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / properties / item / items / additionalProperties
```
Previous value: -falseNew value: +{}
```

added

Input schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / properties / item / items / properties / event

Added value: +{
+  "description": "A list of scripts configured to run when specific events occur. Include this on requests inside folders to keep their pre-request (`prerequest`) and post-response (`test`) scripts — scripts you omit here are not carried over from the stored item.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "description": "The event's ID.",
+        "type": "string"
+      },
+      "listen": {
+        "description": "The `prerequest` (pre-request) or `test` (post-response) value.",
+        "enum": [
+          "test",
+          "prerequest"
+        ],
+        "type": "string"
+      },
+      "script": {
+        "additionalProperties": false,
+        "description": "Information about the Javascript code that runs when the event fires.",
+        "properties": {
+          "exec": {
+            "description": "A list of script strings, where each line represents a line of code.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "id": {
+            "description": "The script's ID.",
+            "type": "string"
+          },
+          "type": {
+            "description": "The type of script. For example, `text/javascript`.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "listen"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedInput schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / properties / item / items / properties / request / additionalProperties
```
Previous value: -falseNew value: +{}
```
changedInput schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / properties / request / additionalProperties
```
Previous value: -falseNew value: +{}
```

added

Input schema / properties / collection / properties / item / items / properties / item / items / properties / item / items / properties / request / properties / auth

Added value: +{
+  "additionalProperties": {},
+  "description": "The request's authentication. Set `type` and include the matching credential array, for example `{ \"type\": \"bearer\", \"bearer\": [{ \"key\": \"token\", \"value\": \"...\" }] }`.",
+  "properties": {
+    "type": {
+      "enum": [
+        "noauth",
+        "basic",
+        "bearer",
+        "apikey",
+        "digest",
+        "oauth1",
+        "oauth2",
+        "hawk",
+        "awsv4",
+        "ntlm",
+        "edgegrid"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

changedInput schema / properties / collection / properties / item / items / properties / item / items / properties / request / additionalProperties
```
Previous value: -falseNew value: +{}
```
changedInput schema / properties / collection / properties / item / items / properties / item / items / properties / request / properties / auth / additionalProperties
```
Previous value: -falseNew value: +{}
```

added

Input schema / properties / collection / properties / item / items / properties / item / items / properties / request / properties / auth / description

Added value: +"The request's authentication. Set `type` and include the matching credential array, for example `{ \"type\": \"bearer\", \"bearer\": [{ \"key\": \"token\", \"value\": \"...\" }] }`."

Changed1 schema field changedv2.12.3Sep 9, 2026
- addedInput schema / properties / collection / description
```
Added value: +"Information about the collection."
```

Changed3 schema fields changedv2.12.0Aug 19, 2026

removedInput schema / properties / collection / properties / info / properties / schema / const
```
Removed value: -"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
```

changedInput schema / properties / collection / properties / info / properties / schema / description

Previous value: -"The \"https://schema.getpostman.com/json/collection/v2.1.0/collection.json\" Postman Collection Format v2.1.0 schema."New value: +"The \"https://schema.postman.com/json/collection/v2.1.0/collection.json\" Postman Collection Format v2.1.0 schema."

addedInput schema / properties / collection / properties / info / properties / schema / enum

Added value: +[
+  "https://schema.postman.com/json/collection/v2.1.0/collection.json",
+  "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+]

Changed1 schema field changedv2.8.9May 14, 2026

addedInput schema / properties / collection / properties / item / items / properties / item

Added value: +{
+  "description": "A list of items contained in this folder. Use this property to create folder structures within the collection. Each item can be a request (with a 'request' property) or a nested folder (with its own 'item' property). Omit the 'request' property for folder items.",
+  "items": {
+    "additionalProperties": false,
+    "description": "A nested collection item — either a request (has 'request') or a folder (has 'item').",
+    "properties": {
+      "description": {
+        "description": "The item's description.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "item": {
+        "description": "Nested folder items for deeper folder structures.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "description": {
+              "description": "The item's description.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "item": {
+              "description": "Further nested folder items.",
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "request": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "method": {
+                        "type": "string"
+                      },
+                      "url": {
+                        "anyOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "additionalProperties": false,
+                            "properties": {
+                              "raw": {
+                                "type": "string"
+                              }
+                            },
+                            "type": "object"
+                          }
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "name": {
+              "description": "The item's name.",
+              "type": "string"
+            },
+            "request": {
+              "additionalProperties": false,
+              "description": "The request definition.",
+              "properties": {
+                "body": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "mode": {
+                      "type": "string"
+                    },
+                    "raw": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "header": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "key": {
+                        "type": "string"
+                      },
+                      "value": {
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "method": {
+                  "enum": [
+                    "GET",
+                    "PUT",
+                    "POST",
+                    "PATCH",
+                    "DELETE",
+                    "COPY",
+                    "HEAD",
+                    "OPTIONS",
+                    "LINK",
+                    "UNLINK",
+                    "PURGE",
+                    "LOCK",
+                    "UNLOCK",
+                    "PROPFIND",
+                    "VIEW"
+                  ],
+                  "type": "string"
+                },
+                "url": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "raw": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    }
+                  ]
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "name": {
+        "description": "The item's name.",
+        "type": "string"
+      },
+      "request": {
+        "additionalProperties": false,
+        "description": "The request definition. Include for request items, omit for folder items.",
+        "properties": {
+          "auth": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "enum": [
+                  "noauth",
+                  "basic",
+                  "bearer",
+                  "apikey",
+                  "digest",
+                  "oauth1",
+                  "oauth2",
+                  "hawk",
+                  "awsv4",
+                  "ntlm",
+                  "edgegrid"
+                ],
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "body": {
+            "additionalProperties": false,
+            "properties": {
+              "mode": {
+                "enum": [
+                  "raw",
+                  "urlencoded",
+                  "formdata",
+                  "file",
+                  "graphql"
+                ],
+                "type": "string"
+              },
+              "options": {
+                "additionalProperties": false,
+                "properties": {
+                  "raw": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "language": {
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "raw": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "header": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "description": {
+                  "type": "string"
+                },
+                "key": {
+                  "type": "string"
+                },
+                "value": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "method": {
+            "description": "The HTTP method.",
+            "enum": [
+              "GET",
+              "PUT",
+              "POST",
+              "PATCH",
+              "DELETE",
+              "COPY",
+              "HEAD",
+              "OPTIONS",
+              "LINK",
+              "UNLINK",
+              "PURGE",
+              "LOCK",
+              "UNLOCK",
+              "PROPFIND",
+              "VIEW"
+            ],
+            "type": "string"
+          },
+          "url": {
+            "anyOf": [
+              {
+                "description": "The request's URL string.",
+                "type": "string"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "host": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "path": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "protocol": {
+                    "type": "string"
+                  },
+                  "query": {
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "key": {
+                          "type": "string"
+                        },
+                        "value": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "raw": {
+                    "description": "The request's raw URL.",
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Changed2 schema fields changedv2.8.7May 4, 2026
- changedInput schema / properties / collection / properties / info / properties / name / description
```
Previous value: -"The collection's name."New value: +"The collection's name. Must not be empty."
```
- addedInput schema / properties / collection / properties / info / properties / name / minLength
```
Added value: +1
```
First observedJan 14, 2026

TDQS

B3.3/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, idempotentHint=false, destructiveHint=false, and openWorldHint=true, so the write nature is covered. The description adds one genuinely non-obvious side effect: without a workspace, the collection lands in the oldest personal Internal workspace owned by the caller. That said, this note conflicts with the schema, which marks workspace as required, leaving the agent unsure which source to trust, and nothing is said about permissions, duplicate-name handling, or limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences with the core action front-loaded and the caveat clearly separated under a bolded 'Note:' label. No filler, no repetition of what the schema already states.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is complex (deeply nested collection object, no output schema), yet the description says nothing about the return value, error modes, or what happens on name collisions. It is minimally viable because the schema is fully documented and annotations cover the safety profile, but the lack of any response or failure information leaves a real gap for a create operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters and their nested structure, giving a baseline of 3. The description adds a pointer to the external Collection v2.1.0 schema doc, which is useful when constructing the large nested 'collection' object, but it gives no additional semantics for the workspace parameter and its stated default contradicts the schema's required flag.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource ('Creates a collection') and pins the accepted format to the Postman Collection v2.1.0 schema, which is a meaningful detail. It does not, however, distinguish this tool from close siblings such as createCollectionRequest, generateCollection, or duplicateCollection, so an agent must infer the boundary itself.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use guidance, no prerequisites, and no naming of an alternative for the create-a-collection case. The only contextual sentence describes a default placement behavior, which is a behavioral detail rather than usage guidance for choosing this tool over its siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Create a collection

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools