Create contact role
Creates a role relationship between a contact and company, with certification level, powers, and validity period.
Company / contact
Create contact role
Companies & contacts
Typed result
Vue d’ensemble
Creates a role relationship between a contact and company, with certification level, powers, and validity period.
Exemple
Declare that a certified contact is the company's legal representative or payment authorizer with bounded authority.
Parameters 9
company
Platform company on which the operation must act.
contact
Platform contact concerned by the operation.
role_type
Business responsibility of the contact toward the company, for example legal representative or billing contact.
certification_level
Certification level applied to the contact role according to available evidence.
source_reference
Stable reference from your source system, used for correlation and idempotency when the operation contract provides for it.
metadata
Free-form integration metadata to associate with the resource, following the flat
common.metadata contract.max_power_amount
Maximum amount for which this role authorizes the contact to act when the role type supports it.
authorized_acts
Business acts explicitly authorized for this contact role.
valid_for
Validity period of the contact role when it is not permanent.
Outputs 1
contact_role
Canonical contact role obtained or created by the operation.
Behavior
The role becomes an independent resource materializing why, and within which limits, the contact may act for the company.
Limits and responsibilities
- A role must not encode authority that the available evidence does not justify.
- Expired or revoked roles must not be treated as current authorization.