Skip to main content
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 our Webhooks Reference.

​
The webhook object

​
Attributes

  • id (string (uuid), optional): Unique ID of the webhook.

{
"id": "580dca76-c024-4458-bb10-a2111ad4063e",
"created_at": "2019-11-27T15:54:59.440Z",
"updated_at": "2019-11-27T15:54:59.440Z",
"events": [
"*"
],
"name": "All webhooks",
"secret": null,
"url": "https://webhooks-backend.com/argyle",
"config": null
},
null,
2

​
Create a webhook

POST /v1/webhooks
  • Create a new webhook.
  • This request returns the created webhook object.

​
Request body

  • name (string, required): An arbitrary name that is sent back to your system in the webhook payload.
  • events (array of strings, required): An array of Argyle webhook event types. Specify [’*’] to subscribe to all webhook events.
  • url (string, required): The backend website where you want to receive the webhook.
curl --request POST \\
--url https://api.argyle.com/v1/webhooks \\
--header 'accept: application/json' \\
--header 'content-type: application/json' \\
--data '{
"events": ["accounts.connected", "accounts.updated"],
"name": "name-for-the-webhook-subscription",
"url": "https://your-webhook-backend.com",
"config": { "include_resource": true },
"secret": "optional-secret"
}'


{
  "id": "018050ec-522f-1725-0906-320116f36aa6",
  "name": "name-for-the-webhook-subscription",
  "events": ["accounts.connected", "accounts.updated"],
  "config": {},
  "secret": null,
  "url": "https://your-webhook-backend.com",
  "created_at": "2022-04-22T10:58:26.480Z",
  "updated_at": "2022-04-22T10:58:26.480Z"
},
null,
2

​
Retrieve a webhook

GET /v1/webhooks/{id}
  • Retrieve a webhook object with the supplied ID.
  • This request returns a webhook object if you provided a valid identifier.

​
Path parameters

  • id (string (uuid), required): ID of the webhook.
curl --request GET \\
--url https://api.argyle.com/v1/webhooks/{id} \\
--header 'accept: application/json' \\
--header 'content-type: application/json'
  


{
  "id": "018050c5-9af3-4009-14d1-745fd94049c3",
  "name": "Account added",
  "events": [
"accounts.added"
  ],
  "config": {
"include_resource": true
  },
  "secret": null,
  "url": "https://webhook.site/#!/251acbda-9bd7-445d-9ae3-17c8d2f0f238",
  "created_at": "2022-04-22T10:16:09.204Z",
  "updated_at": "2022-04-22T10:54:17.524Z"
},
null,
2

​
List webhooks

GET /v1/webhooks
  • List all webhooks.
  • This request returns an object with a results property that contains an array of up to limit webhook objects.

​
Query parameters

curl --request GET \\
--url https://api.argyle.com/v1/webhooks?limit=2 \\
--header 'accept: application/json' \\
--header 'content-type: application/json'
  


[
  {
"id": "018050c5-9af3-4009-14d1-745fd94049c3",
"name": "Account added",
"events": [
  "accounts.added"
],
"config": {
  "include_resource": true
},
"secret": null,
"url": "https://webhook.site/#!/251acbda-9bd7-445d-9ae3-17c8d2f0f238",
"created_at": "2022-04-22T10:16:09.204Z",
"updated_at": "2022-04-22T10:54:17.524Z"
  },
  {
"id": "017efe13-4336-be71-0f32-529ba362f787",
"name": "Account updated",
"events": [
  "accounts.updated"
],
"config": {
  "include_resource": true
},
"secret": "8500588670cf4e4d83a9a68259429733",
"url": "https://eo7fvts7a5ivh78.m.pipedream.net",
"created_at": "2022-02-15T15:49:42.327Z",
"updated_at": "2022-04-19T22:49:13.761Z"
  }
],
null,
2

​
Delete a webhook

DELETE /v1/webhooks/{id}
  • Remove a webhook and unsubscribe your system from the events in the deleted webhook.
  • This request returns an empty response body.

​
Path parameters

  • id (string (uuid), required): ID of the webhook to be deleted.
curl --request DELETE \\
--url https://api.argyle.com/v1/webhooks/{id} \\
--header 'accept: application/json' \\
--header 'content-type: application/json'
  


"204 status code: No content.",
null,
2