person.id, and you can read everything else through the API.
When person.id is set
Rollout adds person.id to the context when all of these are true:
- One of your consumers has a live credential for the marketplace’s CRM, whose
credential key is the agent’s id in that CRM, the context’s
user.id. This is usually because the agent connected their CRM account to your app through Rollout Link. - That credential has synced the contact.
- The CRM’s connector can map the CRM’s id for a contact to its Universal API record. CINC’s can.
person.id. You still have crm.personId, the
CRM’s own id. A contact created in the CRM moments ago may have no person.id
until the next sync reaches it.
Read the contact
Withperson.id, fetch the contact from the Universal API, using the
credential the agent connected:
authToken and credentialId are the same ones you use for any Universal API
request. See Making API requests.
From there you can read the contact’s notes, tasks and other records, and write
back to the CRM, as with any Universal API credential. Don’t write to a CRM on a
preview.