Skip to main content
POST
/
accounts
/
{account_id}
/
funding-sources
/
plaid
/
connect
Connect a bank account via Plaid
curl --request POST \
  --url https://service.bluumfinance.com/v1/accounts/{account_id}/funding-sources/plaid/connect \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "public_token": "public-production-abc123def456"
}
'
{
  "status": "success",
  "message": "Account connected successfully",
  "data": {
    "item": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "itemId": "item_abc123",
      "institutionId": "ins_123456",
      "institutionName": "Chase Bank",
      "status": "ACTIVE",
      "accounts": [
        {
          "id": "234f5678-f9ac-23e4-b567-537725285115",
          "accountId": "acc_1234567890",
          "accountName": "Checking Account",
          "accountType": "depository",
          "accountSubtype": "checking",
          "mask": "0000"
        }
      ],
      "createdAt": "2026-01-22T10:30:00Z",
      "updatedAt": "2026-01-22T10:30:00Z"
    }
  }
}

Authorizations

Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

account_id
string<uuid>
required

Account ID

Body

application/json
public_token
string
required

Public token from Plaid Link

Example:

"public-production-abc123def456"

Response

Account connected successfully

status
string
Example:

"success"

message
string
Example:

"Account connected successfully"

data
object