Skip to main content
POST
This endpoint accepts a Postman 2.1 collection JSON and runs the same two-phase parse-then-commit flow as the OpenAPI / Swagger importers.
Postman folders become tags on the resulting tools, and {{variable}} placeholders that resolve against the collection’s environment / global variables are substituted at parse time. Unresolved placeholders are left in the URL so you can wire them up to tool inputs later.
Phase 1 (no commit flag) parses the collection and returns candidates with temp_ids. Phase 2 (commit: true) takes selected_temp_ids and writes the chosen tools. Imports default to draft so nothing goes live without a review pass.

Path Parameters

string
required
The UUID of the server to import into (e.g. 836995ae-1cff-41ec-823e-a4f07ccca3a0). Numeric IDs are also accepted for backwards compatibility.

Body Parameters

string
default:"text"
Where the collection content comes from. One of: text (use content), url (use url).
string
Raw Postman collection JSON. Required when source is text. Hard cap of 10 MB.
string
Public URL to fetch the collection from (Postman’s “raw” share link works). Required when source is url.
boolean
default:"false"
When false (default), parse and return candidates only. When true, persist the candidates listed in selected_temp_ids.
array
Array of temp_id strings identifying which requests to create as tools. Required when commit is true.
string
default:"skip"
Slug-collision policy. One of: skip, duplicate.
string
default:"draft"
Status for newly created tools. One of: draft, active.

Status Codes