POST
/
accounts
/
{account_id}
/
relationships
Create account relationship
curl --request POST \
  --url https://api-sandbox.synctera.com/v0/accounts/{account_id}/relationships \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "relationship_type": "ACCOUNT_HOLDER"
}'
{
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "relationship_type": "ACCOUNT_HOLDER"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Path Parameters

account_id
string<uuid>
required

Unique identifier for the account.

Example:

"57826c51-e4ff-4e57-9558-08cab6b963c7"

Body

application/json

Account relationship object

The relationship of the account and the customer/business. Either customer_id OR business_id must be specified, but not both.

Response

201
application/json

Account relationship object

The relationship of the account and the customer/business. The relationship of the account and the customer/business. Either customer_id OR business_id must be specified, but not both.