contact/get

Retrieve a single Contact record from Salesforce by its ID.

When to Use

Retrieve contact details for personalizing an email or document template.
Fetch the contact's account link before creating a support case.
Verify a contact exists before attempting to update or delete it.
Load contact data into a notification that goes to the assigned rep.
Retrieve mailing address for shipping or physical correspondence workflows.

Configuration

Connection

Field	Type	Required	Description
`InstanceUrl`	string	required	Salesforce org URL.
`AccessToken`	string	required	Valid OAuth2 access token.

Operation Fields

Field	Type	Required	Description
`ContactId`	string	required	18-character Salesforce Contact ID.

Sample Configuration

{
  "Resource": "contact",
  "Operation": "get",
  "InstanceUrl": "https://myorg.my.salesforce.com",
  "AccessToken": "{{credentials.salesforce.accessToken}}",
  "ContactId": "{{nodes.ConvertLead.contactId}}"
}

Validation Errors

Error Code	Condition
`CFG_MISSING_INSTANCE`	`InstanceUrl` is missing.
`CFG_MISSING_TOKEN`	`AccessToken` is missing.
`VAL_MISSING_FIELD`	`ContactId` is missing.
`UNEXPECTED_ERROR`	Unexpected exception.

Output

Success Port

Field	Type	Description
`Id`	string	Salesforce Contact ID.
`FirstName`	string	First name.
`LastName`	string	Last name.
`Email`	string	Email address.
`Phone`	string	Office phone.
`MobilePhone`	string	Mobile phone.
`Title`	string	Job title.
`Department`	string	Department.
`AccountId`	string	Linked Account ID.
`OwnerId`	string	Contact owner User ID.
`CreatedDate`	string	ISO 8601 creation timestamp.

Error Port

Field	Type	Description
`errorCode`	string	Machine-readable error code.
`message`	string	Human-readable error description.

Sample Output

{
  "Id": "0035g000006LmnOPQ",
  "FirstName": "Alex",
  "LastName": "Rivera",
  "Email": "alex.rivera@acme.com",
  "Phone": "+1-555-0300",
  "Title": "Director of Procurement",
  "Department": "Finance",
  "AccountId": "0015g000007HijKAB",
  "OwnerId": "0055g000007AbcDEF",
  "CreatedDate": "2026-05-26T11:30:00.000Z"
}

Expression Reference

Expression	Description
`{{nodes.GetContact.Email}}`	Contact email address.
`{{nodes.GetContact.AccountId}}`	Linked Account ID.
`{{nodes.GetContact.FirstName}}`	Contact first name.

Node Policies & GuardRails

Policy	Detail
Credential storage	Store `AccessToken` in BizFirst Credentials Manager.
Not Found handling	If the contact ID does not exist, the node routes to the error port. Always handle it.
Read permissions	Authenticated user must have Read access to the Contact object.
Error port wiring	Always wire the error port.
Sandbox testing	Test in sandbox before production.

Examples

Personalize Email After Case Creation

{
  "ContactId": "{{nodes.CreateCase.contactId}}"
}
// Email: "Hi {{nodes.GetContact.FirstName}}, your case has been received..."

Pre-Check Before Opportunity Update

{
  "ContactId": "{{trigger.contactId}}"
}
// IfCondition: {{nodes.GetContact.AccountId}} == {{trigger.expectedAccountId}}

Fetch Mailing Address for Shipping

{
  "ContactId": "{{trigger.contactId}}"
}
// Shipping node: {{nodes.GetContact.MailingStreet}}, {{nodes.GetContact.MailingCity}}