HelperStable

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

companyRequisCompany
Platform company on which the operation must act.
contactRequisContact
Platform contact concerned by the operation.
role_typeRequisenum
Business responsibility of the contact toward the company, for example legal representative or billing contact.
certification_levelRequisenum
Certification level applied to the contact role according to available evidence.
source_referenceOptionnelstring
Stable reference from your source system, used for correlation and idempotency when the operation contract provides for it.
metadataOptionnelmetadata
Free-form integration metadata to associate with the resource, following the flat common.metadata contract.
max_power_amountOptionnelamount
Maximum amount for which this role authorizes the contact to act when the role type supports it.
authorized_actsOptionnelstring[]
Business acts explicitly authorized for this contact role.
valid_forOptionnelduration
Validity period of the contact role when it is not permanent.

Outputs 1

contact_roleContact 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.