Salesforce Integration User

Last updated: September 19, 2026

When using Spotlight.ai in Salesforce, most interactions between Spotlight.ai's micro services and Salesforce execute in the context of the currently logged in user. The exception is when Spotlight.ai receives a Platform Event from Salesforce Change Data Capture. If the change is made outside of the user's interaction with Spotlight.ai components on the Opportunity Lightning Record Page such as from a bulk update tool used by a System Administrator, then Spotlight.ai will synchronize data using a fallback account. The best practice for the fallback account is to create an integration user in Salesforce.

Integration user requirements

As the integration user acts as a fallback when the security context of the user cannot be determined, it needs to have privileges that permit it to complete synchronization processes as defined in this article: https://support.spotlight.ai/article/13-synchronizing-salesforce-and-spotlight-ai-data.

  • Assigned access to the Connected App named Spotlight.ai Connected App.

  • System Permissions

    • REST API Enabled

    • API Only User (not strictly required but follows principle of least privilege)

  • Able to view any opportunity (not be subject to Role limitations)

  • Write permissions for Spotlight's Opportunity fields (all start with the namespace spai__)

    • Spotlight Score (spai__Spotlight_Score__c)

    • Discovery Score (spai__Discovery_Score__c)

    • Value Score (spai__Value_Score__c)

    • MEDDICC Status URL (spai__MEDDICC_Status_URL__c)

    • At Risk (spai__At_Risk__c) - deprecated

    • MEDDICC Score (spai__MEDDICC_Score__c) - deprecated

  • Read and Write permission to Contact and OpportunityContact

  • Read permissions for the following Opportunity, Account and User fields:

    • Opportunity.Id

    • Opportunity.Name

    • Opportunity.AccountId

    • Opportunity.Type

    • Opportunity.StageName

    • Opportunity.ForecastCategory

    • Opportunity.Amount

    • Opportunity.CloseDate

    • Opportunity.CreatedDate

    • Opportunity.IsClosed

    • Opportunity.OwnerId

    • Owner.FirstName

    • Owner.LastName

    • Owner.Email

    • Owner.Username

    • Owner.Name

    • Account.Id

    • Account.Name

    • Contact.Id

    • Contact.FirstName

    • Contact.LastName

    • Contact.Name

    • Contact.Email

    • Contact.Title

    • Contact.AccountId

    • AccountContactRole.Id

    • AccountContactRole.AccountId

    • AccountContactRole.ContactId

    • OpportunityContactRole.Id

    • OpportunityContactRole.ContactId

    • OpportunityContactRole.OpportunityId

    • OpportunityContactRole.Role

    • Any Opportunity fields explicitly setup for read or write integration with Spotlight.ai variables

  • Additionally, we recommend enabling a bypass for Validation Rules for this user