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

# Salesforce

> Connect to Salesforce CRM.

Humm queries your Salesforce accounts, contacts, opportunities, and custom objects via SOQL. Ask about pipeline, account health, recent leads, or any object in your org.

## Tools

| Tool                    | Description                                     |
| ----------------------- | ----------------------------------------------- |
| `SALESFORCE_QUERY_SOQL` | Execute SOQL queries against Salesforce objects |

## SOQL Query Examples

Humm uses Salesforce Object Query Language (SOQL) to retrieve data. Here are common patterns:

```
# Find a user by email
SELECT Id, Name FROM User WHERE Email = 'user@example.com'

# List accounts with health scores
SELECT Id, Name, Health_Score__c FROM Account WHERE Health_Score__c != null

# Open opportunities closing this quarter
SELECT Id, Name, Amount, CloseDate FROM Opportunity
WHERE StageName != 'Closed Won' AND StageName != 'Closed Lost'
AND CloseDate = THIS_QUARTER

# Contacts at a specific account
SELECT Id, Name, Email, Phone FROM Contact WHERE AccountId = '001XXXXXXXXXXXX'

# Recent leads
SELECT Id, Name, Company, Status FROM Lead
WHERE CreatedDate = LAST_N_DAYS:7 ORDER BY CreatedDate DESC
```

## Authentication

<Card title="OAuth" icon="plug">
  Connect securely via Salesforce OAuth. No credentials stored—just authorize Humm in your Salesforce org.
</Card>