Create a request

POST

/collections/:collectionId/requests

POST

/collections/:collectionId/requests

$ curl -X POST https://api.getpostman.com/collections/12ece9e1-2abf-4edc-8e34-de66e74114d2/requests \
>      -H "x-api-key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Example GET Request",
>   "description": "This is an example GET request.",
>   "method": "GET",
>   "url": "https://postman-echo.com/get?param=value",
>   "queryParams": [
>     {
>       "key": "id",
>       "value": "{{id}}",
>       "description": "Optional. The user'\''s ID.",
>       "enabled": true,
>       "equals": true
>     }
>   ],
>   "dataMode": "raw",
>   "rawModeData": null,
>   "dataOptions": {
>     "raw": {
>       "language": "json"
>     }
>   },
>   "headers": [
>     {
>       "key": "Host",
>       "value": "postman-echo.com"
>     },
>     {
>       "key": "user-agent",
>       "value": "curl/7.88.1"
>     },
>     {
>       "key": "accept",
>       "value": "*/*"
>     },
>     {
>       "key": "content-type",
>       "value": "application/json"
>     }
>   ]
> }'

1 {
2   "data": {
3     "id": "c82dd02c-4870-4907-8fcb-593a876cf05b",
4     "name": "Example GET Request",
5     "owner": "12345678",
6     "folder": null,
7     "responses": [],
8     "collection": "12ece9e1-2abf-4edc-8e34-de66e74114d2",
9     "responses_order": [],
10     "createdAt": "2023-09-07T13:33:17.912Z",
11     "updatedAt": "2023-09-07T13:33:17.912Z",
12     "lastUpdatedBy": "12345678",
13     "dataMode": "raw",
14     "dataOptions": {
15       "raw": {
16         "language": "json"
17       }
18     },
19     "description": "This is an example GET request.",
20     "headerData": [],
21     "headers": [
22       {
23         "key": "Host",
24         "value": "postman-echo.com"
25       },
26       {
27         "key": "user-agent",
28         "value": "curl/7.88.1"
29       },
30       {
31         "key": "accept",
32         "value": "*/*"
33       },
34       {
35         "key": "content-type",
36         "value": "application/json"
37       }
38     ],
39     "method": "GET",
40     "queryParams": [
41       {
42         "description": "Optional. The user's ID.",
43         "enabled": true,
44         "equals": true,
45         "key": "id",
46         "value": "{{id}}"
47       }
48     ],
49     "rawModeData": null,
50     "url": "https://postman-echo.com/get?param=value"
51   },
52   "meta": {
53     "action": "import",
54     "model": "request"
55   },
56   "model_id": "c82dd02c-4870-4907-8fcb-593a876cf05b",
57   "revision": 32456338071
58 }

Creates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation.

Note:

It is recommended that you pass the name property in the request body. If you do not, the system uses a null value. As a result, this creates a request with a blank name.

Creates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a request with a blank name.

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)>.

Path parameters

collectionIdstringRequired

The collection's ID.

Query parameters

folderIdstringOptional

The folder ID in which to create the request. By default, the system will create the request at the collection level.

Request

This endpoint expects an object.

namestringOptional

The request’s name. It is recommended that you pass the name property in the request body. If you do not, the system uses a null value. As a result, this creates a request with a blank name.

descriptionstring or nullOptional

The request's description.

methodenumOptional

The request's HTTP method.

urlstring or nullOptional

The request's URL.

headerDatalist of objectsOptional

The request's headers.

queryParamslist of objectsOptional

The request's query parameters.

dataModeenumOptional

The request body's data mode.

datalist of objectsOptional

The request body's form data.

rawModeDatastring or nullOptional

The request body's raw mode data.

graphqlModeDataobjectOptional

The request body's GraphQL mode data.

dataOptionsobjectOptional

Additional configurations and options set for the request body's various data modes.

authobjectOptional

The request's authentication information.

eventslist of objectsOptional

A list of scripts configured to run when specific events occur.

Response

Successful Response

dataobject

Information about the created request. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation.

metamap from strings to any

A Postman-specific response that contains information about the internal performed operation.

model_idstring

The request's ID.

revisiondouble

An internal revision ID. Its value increments each time the resource changes. You can use this ID to track whether there were changes since the last time you fetched the resource.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error