Skip to content

Hub Accounts: add endpoints for managing associated accounts#361

Open
cleareth wants to merge 16 commits intomainfrom
716611hubRelated
Open

Hub Accounts: add endpoints for managing associated accounts#361
cleareth wants to merge 16 commits intomainfrom
716611hubRelated

Conversation

@cleareth
Copy link
Copy Markdown
Contributor

@cleareth cleareth commented Mar 26, 2026

Add new associated and nominated accounts endpoints. These new endpoints allow you to connect accounts to Hub Accounts as either nominated or associated. These related accounts may send or receive funds to/from a Hub Account for a specific purpose, fulfilling a key function of a financial service.

The new endpoints include:

  • POST /v1/accounts/{accountId}/related-accounts
  • GET /v1/accounts/{accountId}/related-accounts
  • PATCH /v1/accounts/{accountId}/related-accounts/{iban}
  • DELETE /v1/accounts/{accountId}/related-accounts/{iban}

@cleareth cleareth changed the title Hub Accounts: add endpoints for manageing associated accounts Hub Accounts: add endpoints for managing associated accounts Mar 30, 2026
</Callout>
To set or replace the nominated account for a Hub Account, you can use the [POST /v1/accounts/{accountId}/related-accounts](#add-an-associated-or-nominated-account) (preferred), or the [PUT /v1/accounts/{accountId}/nominated-account](#set-a-nominated-account) endpoint.

You can make payments from a Hub Account to its nominated account via [Faster Payments](../gbp-payments/faster-payments); to receive updates about transactions for a Hub Account, you can subscribe to the [Transaction Settled webhook](../gbp-payments/faster-payments#transaction-settled-webhook).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you only use FPS? I'd clarify that if that's the case--"You can only make payments from a Hub Account to its nominated account..." Right now it sounds ambiguous, like you can use any payment rail but we PREFER FPS

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Opened a query with Developer

cleareth and others added 6 commits March 30, 2026 14:52
Co-authored-by: Eleanor Lovelock <107618484+ClearlyEleanor@users.noreply.github.com>
Co-authored-by: Eleanor Lovelock <107618484+ClearlyEleanor@users.noreply.github.com>
Co-authored-by: Eleanor Lovelock <107618484+ClearlyEleanor@users.noreply.github.com>
Co-authored-by: Eleanor Lovelock <107618484+ClearlyEleanor@users.noreply.github.com>
Co-authored-by: Eleanor Lovelock <107618484+ClearlyEleanor@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants