Create a Consumer Relationship
Attaches one of your consumers to another consumer’s account as an authorized user. The consumer in the path is the account holder. Sending a pairing that already exists updates that relationship instead of creating a new one: it is set back to active, its relationship_type is replaced and 200 OK is returned. Requires the api:write scope.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
The id of the account holder.
Request
Always authorized_user.
Response
The relationship already existed. It is now active and carries the relationship_type you sent.
The id of the relationship.
The id of the business, or of the consumer who holds the account, that the relationship belongs to.
Whether the principal is a business or a consumer.
Share of the business the attached consumer owns, from 0 to 100 with two decimal places. Set for business relationships, null otherwise.
What the account holder is to the authorized user. Set for consumer relationships, null otherwise.
What the attached consumer is to the principal. A business grants beneficial_owner or control_person; a consumer grants authorized_user.
active while the relationship is in effect. Removed relationships stay readable with the status removed.

