> ## Documentation Index
> Fetch the complete documentation index at: https://greatquestion.co/support/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce Integration

> Sync candidates between Salesforce and Great Question, and push research attributes back to your CRM.

The Salesforce integration keeps candidates in sync between Salesforce and Great Question. You can import contacts as candidates, and push custom attributes and unsubscribe statuses back to Salesforce so your CRM stays current.

## Connect Salesforce

1. Go to **Settings → Integrations → Salesforce** and click **Connect**.<br />
   <Frame>
     <img src="https://mintcdn.com/greatquestion/A8McTIAOp1gNGsGm/support/images/image-14.png?fit=max&auto=format&n=A8McTIAOp1gNGsGm&q=85&s=c97a03119f531b3a074d1527173c03d8" alt="Image" width="1784" height="156" data-path="support/images/image-14.png" />
   </Frame>
2. You'll be redirected to Salesforce to authenticate.
3. After authorizing, you're returned to Great Question with the connection active.

## How candidate sync works

* Candidates import automatically every 24 hours, at midnight PST.
* You can trigger a manual import at any time from the **Candidates** page.
* By default, only Contacts flagged with a `gq_import__c` field set to true are imported. You can also enable **sync back** so that when a new candidate signs up in Great Question, the same flag gets written back to their Salesforce record.

## Push candidates back to Salesforce

Enable **Push candidates** to export data from Great Question back to Salesforce Contacts. It runs automatically every 24 hours (around 11 PM PST) in addition to being available on demand.

* Only updates contacts that were previously synced from Salesforce.
* Target fields must be created in Salesforce beforehand.

## Custom attributes

Create custom attributes under **Settings → Candidate Attributes**. Attribute values appear in each candidate's profile.

<Tip>
  For custom Salesforce fields without an explicit mapping, the integration falls back to CamelCase naming with Salesforce's standard `__c` custom-field suffix (for example, `ProjectStatus__c`). If you map a field explicitly in Great Question, you can use any Salesforce field name.
</Tip>

## Deleted records

Salesforce's own `IsDeleted` field is used to detect removed Contacts. Choose what happens on your side when that happens — **delete** the candidate, **unsubscribe** them, or **do nothing** — under the integration's configuration.

***

**Still need help?** Contact us at [support@greatquestion.co](mailto:support@greatquestion.co) — median response time is 19 minutes during [support hours](https://greatquestion.co/features/about-our-support-team).