This section details how to create a webhook subscription to deliver webhooks to a specified URL.
POST https://api.dwolla.com/webhook-subscriptions
Parameter | Required | Type | Description |
---|---|---|---|
url | yes | string | Where Dwolla should deliver the webhook notification. |
secret | yes | string | A random, secret key, only known by your application. This secret key should be securely stored and used later when processing and validating the webhook request is from Dwolla. |
HTTP Status | Code | Description |
---|---|---|
400 | MaxNumberOfResources | The maximum number of subscriptions has been reached. |
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var requestBody = {
url: "http://myawesomeapplication.com/destination",
secret: "your webhook secret",
};
dwolla
.post("webhook-subscriptions", requestBody)
.then((res) => res.headers.get("location")); // => 'https://api-sandbox.dwolla.com/webhook-subscriptions/5af4c10a-f6de-4ac8-840d-42cb65454216'
Use sandbox environment to test API requests.
All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.