# Set up SourceTag with Salesforce

Canonical: https://sourcetag.io/docs/setup-salesforce

When a visitor submits a form with SourceTag data, the attribution fields need somewhere to go in Salesforce. You need to create custom contact fields that match the SourceTag field names.

## What you need

- SourceTag installed and form hidden fields set up
- Salesforce account with admin access

## Step 1: Go to custom fields settings

In Salesforce, navigate to **Setup > Object Manager > Contact > Fields & Relationships**.
## Step 2: Create custom fields

Create a new custom text field for each SourceTag data point:

### Core fields (create these)

| Field name | Label | Type |
|-----------|-------|------|
| `st_fc_channel` | First Click Channel | Text |
| `st_fc_detail_1` | First Click Smart Field 1 | Text |
| `st_fc_detail_2` | First Click Smart Field 2 | Text |
| `st_fc_detail_3` | First Click Smart Field 3 | Text |
| `st_fc_detail_4` | First Click Smart Field 4 | Text |
| `st_lc_channel` | Last Click Channel | Text |
| `st_lc_detail_1` | Last Click Smart Field 1 | Text |
| `st_lc_detail_2` | Last Click Smart Field 2 | Text |
| `st_lc_detail_3` | Last Click Smart Field 3 | Text |
| `st_lc_detail_4` | Last Click Smart Field 4 | Text |
| `st_fc_landing_page` | First Click Landing Page | Text |
| `st_lc_landing_page` | Last Click Landing Page | Text |

### Optional extended fields

| Field name | Label | Type |
|-----------|-------|------|
| `st_fc_click_id` | First Click Click ID | Text |
| `st_lc_click_id` | Last Click Click ID | Text |
| `st_visits` | Visit Count | Number |
| `st_days_to_convert` | Days to Convert | Number |
| `st_device` | Device Type | Text |

See [Captured Fields](https://sourcetag.io/docs/captured-fields) for the full list of available fields.

## Step 3: Map form fields to CRM fields

If your form builder sends data to Salesforce via an integration (Zapier, native feed, webhook, etc.), make sure the SourceTag form fields are mapped to the corresponding Salesforce custom fields.
## Step 4: Test

Submit a form with UTM parameters and check the contact record in Salesforce. The custom fields should be populated with attribution data.
## Tips

- Add SourceTag fields to a dedicated page layout section (e.g. "SourceTag Attribution") to keep the contact record tidy.
- Salesforce appends `__c` to custom field API names automatically. When mapping form fields to Salesforce in your integration tool (Zapier, Make, etc.), look for `st_fc_channel__c` rather than `st_fc_channel`. This is a Salesforce convention and doesn't affect your form HTML or SourceTag.
- Test with a fresh contact (not one that already exists) for the cleanest test.
