Associate contact to account

The Salesforce associate contact to account action links an existing Salesforce contact record to a specific account. This is a write action that enables agents to create or correct person-account relationships in Salesforce automatically.

Prerequisites

• Your Salesforce org must be connected as a data source in Glean, and an admin must enable the Salesforce action pack and complete Salesforce Actions Setup including OAuth configuration.

• Users must authenticate for Salesforce actions on first use.

• The Salesforce user must have permission to work with the relevant account and contact records.

Supported parameters

Parameter	Type	Description
Account ID	String	The unique identifier of the Salesforce account to associate the contact with. Required.
Contact ID	String	The unique identifier of the Salesforce contact to link to the account. Required.

Usage examples

• "Link contact ID 003PZ000001rbt8YAA to account ID 001PZ000003xyzABC."

• "Associate Abc Xyz's contact record with the Pqr Corporation account."

• "Connect the new contact to account ID 001PZ000004defGHI."

Troubleshooting

• Possible cause: The Salesforce action pack is not added or published in your Glean deployment.
• Fix: In the Glean admin console, go to Platform → Actions, add the Salesforce action pack, link it to your Salesforce datasource, configure authentication, update Publish settings, and save. After that, Salesforce actions should appear under Actions → By datasource → Salesforce.

• Possible cause: The user's connected Salesforce account is missing, inactive, or misconfigured, or the Salesforce connected app is not set up correctly.
• Fix: Ask the user to re-authenticate Salesforce when prompted by Glean. If errors persist, verify the Salesforce connected app configuration (callback URL and scopes) and confirm that Salesforce Actions Setup is complete.

• Possible cause: Salesforce rejected the request due to validation rules, missing required fields, insufficient permissions, or incorrect account or contact identifiers.
• Fix: Check agent run details and Salesforce error messages. Adjust required fields, validation rules, or user permissions. Verify that the account ID and contact ID are correct and that the user has access to both records.

• Possible cause: The action's idempotency behavior may allow multiple association attempts for the same contact and account.
• Fix: Design your agent workflow to check if the contact is already associated with the account before calling this action. Validate the behavior in your Salesforce org before using in high-volume automated workflows.

FAQs

Salesforce allows a contact to be associated with multiple accounts depending on your org configuration. This action will create or update the relationship. Check your Salesforce org's account-contact relationship settings to understand the specific behavior.

This action only creates or updates associations. To remove a contact-account relationship, you would need to use a different Salesforce action or perform the operation directly in Salesforce.

You can find IDs in Salesforce by navigating to the respective records and copying the IDs from the URLs, or use Search contacts and Search accounts actions to programmatically find the IDs based on names or other criteria.