right logo image
right logo image
Log on

2.0.0 filtered by tag: Webhook (3 APIs)

API Host: https://uk.openbankproject.com
Bank
Accounts
Views
Counterparties
Transactions

Create an Account Webhook

Create an Account Webhook

Webhooks are used to call external URLs when certain events happen.

Account Webhooks focus on events around accounts.

For instance, a webhook could be used to notify an external service if a balance changes on an account.

This functionality is work in progress! Please note that only implemented trigger is: OnBalanceChange

Authentication is Mandatory

Typical Successful Response:

								
									
{
  "account_webhook_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f",
  "bank_id":"gh.29.uk",
  "account_id":"8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0",
  "trigger_name":"OnBalanceChange",
  "url":"https://localhost.openbankproject.com",
  "http_method":"POST",
  "http_protocol":"HTTP/1.1",
  "created_by_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "is_active":true
}
Required Roles:
  • CanCreateWebhook - Please login to request this Role
Possible Errors:
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
Implemented in OBPv3.1.0 by createAccountWebhook

Enable/Disable an Account Webhook

Enable/Disable an Account Webhook

Webhooks are used to call external URLs when certain events happen.

Account Webhooks focus on events around accounts.

For instance, a webhook could be used to notify an external service if a balance changes on an account.

This functionality is work in progress! Please note that only implemented trigger is: OnBalanceChange

Authentication is Mandatory

Typical Successful Response:

								
									
{
  "account_webhook_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f",
  "bank_id":"gh.29.uk",
  "account_id":"8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0",
  "trigger_name":"OnBalanceChange",
  "url":"https://localhost.openbankproject.com",
  "http_method":"POST",
  "http_protocol":"HTTP/1.1",
  "created_by_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "is_active":true
}
Required Roles:
  • CanUpdateWebhook - Please login to request this Role
Possible Errors:
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
Implemented in OBPv3.1.0 by enableDisableAccountWebhook

Get Account Webhooks

Get Account Webhooks.

Possible custom URL parameters for pagination:

  • limit=NUMBER
  • offset=NUMBER
  • account_id=STRING
  • user_id=STRING

Authentication is Mandatory

Typical Successful Response:

								
									
{
  "web_hooks":[{
    "account_webhook_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f",
    "bank_id":"gh.29.uk",
    "account_id":"8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0",
    "trigger_name":"OnBalanceChange",
    "url":"https://localhost.openbankproject.com",
    "http_method":"POST",
    "http_protocol":"HTTP/1.1",
    "created_by_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
    "is_active":true
  }]
}
Required Roles:
  • CanGetWebhooks - Please login to request this Role
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
Implemented in OBPv3.1.0 by getAccountWebhooks