Create Webhook

POST https://api.getpostman.com/webhooks?workspace={{workspaceId}}

Creates a webhook that triggers a collection with a custom payload. You can get the webhook's URL from the webhookUrl property in the endpoint's response.

Include the following properties in a webhook object in the request body:

  • name — The webhook's name. On success, the system creates a new monitor with this name in the Monitors tab.
  • collection — The collection UID to trigger when calling this webhook.

Request Params

KeyDatatypeRequiredDescription
workspacestringOptional. A workspace ID in which to create the webhook.

If you do not include this query parameter, the system creates the webhook in your "My Workspace" workspace. | | `` | null | | |

Request Body

{"webhook"=>{"name"=>"{{webhookName}}", "collection"=>"{{collectionUid}}"}}

RESPONSES

status: OK

{"webhook":{"id":"1ed9023a-a863-4290-85cb-5e27cab17932","name":"Externally Triggered Monitor for A(i)ppealing Companies","collection":"24483733-6a545bfb-a72f-4ee8-a1fe-469a34d7cf8b","webhookUrl":"https://newman-api.getpostman.com/run/24483733/53397257-e8b0-4840-88cc-41d1327bf9e2","uid":"24483733-1ed9023a-a863-4290-85cb-5e27cab17932"}}