Webhooks

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, "`activities.added`". Refer to the Webhooks reference for a full list of available event types.
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 `X-Argyle-Signature` header.

Endpoints

Endpoints
Retrieve a webhook - `GET /webhooks/:id`
List webhooks - `GET /webhooks`
Create a webhook - `POST /webhooks`
Delete a webhook - `DELETE /webhooks/:id`

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": "*"}'