---
title: "Connect Bank Account"
method: GET
path: "/organisations/{organisationId}/connect/bank-account"
tags: ["Organisations"]
---

# Connect Bank Account

`GET /organisations/{organisationId}/connect/bank-account`

Calling Connect Bank Account with a valid organisation ID will return a response containing a `url` for you to redirect the user
to the UI to allow them to connect their bank accounts.

You must provide a `returnUrl` query parameter which will be used
to redirect the user back to your system on completion of the bank connection process.

## Path parameters

- `organisationId` string, uuid, required

## Query parameters

- `returnUrl` string

## Headers

- `Crezco-Version` string

## Response `200`

OK

- ConnectResourceRepresentationVersion4
  - `url` string — Url hosted by Crezco that you should redirect the customer to in order for them to connect their payment source

## Other responses

- `400` — Bad Request
- `401` — You do not have access. Check your API key is correct.
- `403` — You do not have access to this organisation.
- `404` — Not Found
- `406` — The version of the API that you requested is not available. Check your Crezco-Version header. If you omit this header you will use the latest version of the API.
- `409` — Conflict
- `429` — You have made too many requests to the API in too short a period. Wait a while and try again.

---

[API](https://skmtc.net/crezco/apis/payables-api.md) · [All operations](https://skmtc.net/crezco/apis/payables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crezco/payables-api/revisions/4427e79fba09/schema)