Postman API
  1. Webhooks
Postman API
  • API
    • Get all APIs
      GET
    • Create API
      POST
    • Delete an API
      DELETE
    • Single API
      GET
    • Update an API
      PUT
    • Get All API Versions
      GET
    • Create API Version
      POST
    • Delete an API Version
      DELETE
    • Get an API Version
      GET
    • Update an API Version
      PUT
    • Get contract test relations
      GET
    • Get documentation relations
      GET
    • Get environment relations
      GET
    • Get integration test relations
      GET
    • Get monitor relations
      GET
    • Get linked relations
      GET
    • Create relations
      POST
    • Create Schema
      POST
    • Get Schema
      GET
    • Update Schema
      PUT
    • Create collection from schema
      POST
    • Get test suite relations
      GET
    • Sync relations with schema
      PUT
  • Collections
    • All Collections
      GET
    • Create Collection
      POST
    • Create a Fork
      POST
    • Merge a Fork
      POST
    • Delete Collection
      DELETE
    • Single Collection
      GET
    • Update Collection
      PUT
  • Environments
    • All Environments
    • Create Environment
    • Delete Environment
    • Single Environment
    • Update Environment
  • Import
    • Import exported data
    • Import external API specification
  • User
    • API Key Owner
  • Mocks
    • All Mocks
    • Create Mock
    • Delete Mock
    • Single Mock
    • Update Mock
    • Publish Mock
    • Unpublish Mock
  • Monitors
    • All Monitors
    • Create Monitor
    • Delete Monitor
    • Single Monitor
    • Update Monitor
    • Run a Monitor
  • Webhooks
    • Create Webhook
      POST
  • Workspaces
    • All workspaces
    • Create Workspace
    • Delete Workspace
    • Single workspace
    • Update Workspace
  1. Webhooks

Create Webhook

POST
/webhooks
Webhooks
Create a webhook that triggers a collection with your custom payload.
You can specify the webhook name and the collection to trigger by using the following attributes of the webhook object on your JSON body:
name: the name of the webhook that you're creating.
collection: the ID of the collection that you want to trigger once this webhook is called.
Once created, the webhook URL can be retrieved by accessing the webhookUrl attribute of the webhook object on the response JSON payload.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.getpostman.com/webhooks' \
--header 'Content-Type: application/json' \
--data-raw '{
    "webhook": {
        "collection": "{{collection_id}}",
        "name": "{{webhook_name}}"
    }
}'
Response Response Example
{}

Request

Query Params
workspace
string 
optional
Body Params application/json
webhook
object 
optional
collection
string 
optional
Example:
{{collection_id}}
name
string 
optional
Example:
{{webhook_name}}
Examples

Responses

🟢200Success
application/json
Body
object {0}
Previous
Run a Monitor
Next
All workspaces
Built with