Learn about the /webhooks
endpoint.
Webhooks provide a way for Argyle to communicate to your servers when specific events happen, such as when an account was successfully connected, new payouts were added, etc.
To start receiving webhooks, you need to build a web application, with a publicly accessible URL. Use that URL to create a webhook subscription.
After subscribing to a webhook, you receive a POST request with the event payload that contains information about the event that has been triggered.
For more information, refer to the Webhooks reference.
Attributes
Attribute | Type | Description |
---|---|---|
id | string | Unique ID of the webhook. |
events | array of strings | An array of Argyle's webhook event types—for example, " |
url | string | The endpoint that is invoked when the specified event occurs. |
config | object | Configuration options of the webhook. Refer to the Webhooks reference to learn more about available configuration parameters. |
name | string | An arbitrary name that is sent back to your system in the webhook payload. |
secret | string | The key that will be used to generate HMAC-SHA512 hex digest value in the |
Endpoints
Endpoints |
---|
Retrieve a webhook - |
List webhooks - |
Create a webhook - |
Delete a webhook - |
Examples
{
"id": "580dca76-c024-4458-bb10-a2111ad4063e",
"created_at": "2019-11-27T15:54:59.440004Z",
"updated_at": "2019-11-27T15:54:59.440056Z",
"events": ["*"],
"name": "All webhooks",
"secret": null,
"url": "https://webhooks-backend.com/argyle",
"config": null
}
$ curl -X POST -u <key_id>:<key_secret> \
https://api-sandbox.argyle.com/v1/webhooks \
-H 'Content-Type: application/json' \
-d '{"name": "webhooks", "url": "http://my.backend/url", "events": "*"}'