POST
/
webhooks
# You can create a webhook that delivers events to `https://endpoint.m.pipedream.net` using the following command:
curl "https://api.pipedream.com/v1/webhooks?url=https://endpoint.m.pipedream.net&name=name&description=description" \
  -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

// Successful API responses contain a webhook ID for the webhook that was created in `data.id` — the string that starts with `wh_` — which you can reference when creating [subscriptions](/docs/rest-api/#subscriptions).
{
  "data": {
    "id": "wh_abc123",
    "user_id": "u_abc123",
    "name": null,
    "description": null,
    "url": "https://endpoint.m.pipedream.net",
    "active": true,
    "created_at": 1611964025,
    "updated_at": 1611964025
  }
}
Creates a webhook pointing to a URL. Configure a subscription to deliver events to this webhook.

​
Endpoint

POST /webhooks?url={your_endpoint_url}&name={name}&description={description}

​
Parameters

​
url
string
required
The endpoint URL where you’d like to deliver events. Any events sent to this webhook object will be delivered to this endpoint URL.This URL must contain, at a minimum, a protocol — one of http or https — and hostname, but can specify resources or ports. For example, these URLs work:
https://example.com
http://example.com
https://example.com:12345/endpoint
but these do not:
# No protocol - needs http(s)://
example.com

# mysql protocol not supported. Must be an HTTP(S) endpoint
mysql://user:pass@host:port
​
name
string
required
The name you’d like to assign to this webhook, which will appear when listing your webhooks.
​
description
string
required
The description you’d like to assign to this webhook.
# You can create a webhook that delivers events to `https://endpoint.m.pipedream.net` using the following command:
curl "https://api.pipedream.com/v1/webhooks?url=https://endpoint.m.pipedream.net&name=name&description=description" \
  -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

// Successful API responses contain a webhook ID for the webhook that was created in `data.id` — the string that starts with `wh_` — which you can reference when creating [subscriptions](/docs/rest-api/#subscriptions).
{
  "data": {
    "id": "wh_abc123",
    "user_id": "u_abc123",
    "name": null,
    "description": null,
    "url": "https://endpoint.m.pipedream.net",
    "active": true,
    "created_at": 1611964025,
    "updated_at": 1611964025
  }
}