---
title: "Create account relationship"
method: POST
path: "/accounts/{account_id}/relationships"
tags: ["Accounts"]
---

# Create account relationship

`POST /accounts/{account_id}/relationships`

Add a customer to an account

## Path parameters

- `account_id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- AccountRelationship — The relationship of the account and the customer/business. Either customer_id OR business_id must be specified, but not both.
  - `business_id` string, uuid — Business associated with the current account. One of business_id or customer_id must be specified.
  - `created_at` string, date-time — Date and time when this association was created.
  - `customer_id` string, uuid — Personal customer associated with the current account. One of customer_id or business_id must be specified.
  - `deleted_at` string, date-time — Date and time when this association was deleted.
  - `id` string, uuid — ID of account relationship
  - `ownership_percentage` number, double — The ownership percentage of the related party.
  - `person_id` string, uuid — Person associated with the current account. This attribute is deprecated and will be removed in a future API version. Use customer_id instead.
  - `relationship_type` 'ACCOUNT_HOLDER' | 'AUTHORIZED_SIGNER' | 'AUTHORIZED_USER' | 'BENEFICIARY' | 'JOINT_ACCOUNT_HOLDER' | 'PRIMARY_ACCOUNT_HOLDER', required — Relationship type
  - `updated_at` string, date-time — Date and time when this association was last updated.

## Response `201`

Account relationship object

- RelationshipResponse — The relationship of the account and the customer/business.
  - `account_id` string, uuid — Account ID
  - `business_id` string, uuid — Business associated with the current account. One of business_id or customer_id must be specified.
  - `created_at` string, date-time — Date and time when this association was created.
  - `customer_id` string, uuid — Personal customer associated with the current account. One of customer_id or business_id must be specified.
  - `deleted_at` string, date-time — Date and time when this association was deleted.
  - `id` string, uuid — ID of account relationship
  - `ownership_percentage` number, double — The ownership percentage of the related party.
  - `person_id` string, uuid — Person associated with the current account. This attribute is deprecated and will be removed in a future API version. Use customer_id instead.
  - `relationship_type` 'ACCOUNT_HOLDER' | 'AUTHORIZED_SIGNER' | 'AUTHORIZED_USER' | 'BENEFICIARY' | 'JOINT_ACCOUNT_HOLDER' | 'PRIMARY_ACCOUNT_HOLDER', required — Relationship type
  - `updated_at` string, date-time — Date and time when this association was last updated.

## Other responses

- `401` — Unauthorized
- `461` — Account has been closed

---

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