Create a Business Relationship
Attaches one of your consumers to a business as a control person or a beneficial owner. The control person is the person with the highest ownership in the business; attach each other person who owns more than 25% as a beneficial owner. Sending a pairing of business, consumer and role that already exists updates that relationship instead of creating a new one: it is set back to active, its ownership_percentage is replaced and 200 OK is returned. Requires the api:write scope on a partner token.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
The id of the business.
Request
control_person for the person with the highest ownership in the business, beneficial_owner for each other person who owns more than 25% of it.
Response
The relationship already existed. It is now active and carries the ownership_percentage 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.

