Skip to main content
POST
/
accounts
/
{accountId}
/
party-roles
Add a party to an account
curl --request POST \
  --url https://api.venlyfinance.com/v1/accounts/{accountId}/party-roles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "partyId": "7e3b9c2a-1f4d-4a8b-9c11-2d6e8f0a1b22",
  "roleType": "ACCOUNT_HOLDER"
}
'
{
  "success": true,
  "result": {
    "partyId": "7e3b9c2a-1f4d-4a8b-9c11-2d6e8f0a1b22",
    "roleType": "ACCOUNT_HOLDER",
    "status": "ACTIVE",
    "createdAt": "2026-01-15T09:30:00",
    "updatedAt": "2026-01-15T09:30:00"
  }
}
Associates a party with the account in a role. A party can hold only one role per account.

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Token endpoints:

Path Parameters

​
accountId
string<uuid>
required

Unique account identifier

Body

application/json
​
partyId
string<uuid>
required

ID of the party to add to the account

​
roleType
enum<string>
required

Role type for the party-account relationship

Available options:
ACCOUNT_HOLDER

Response

Party role added

​
success
boolean

Indicates whether the request was successful

​
result
object

Represents the relationship between a Party and an Account