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

# Default Fields

> Complete reference for all default fields for Conversion Contacts, their sync modes, and Salesforce field mappings.

## Standard Contact Fields

<ResponseField name="email" type="String" required>
  **Email** — The contact's email address.

  | Property           | Value        |
  | :----------------- | :----------- |
  | Default Sync Mode  | Two-Way Sync |
  | Allowed Sync Modes | Two-Way Sync |
  | Read-Only          | Yes          |
  | SF Lead Field      | `Email`      |
  | SF Contact Field   | `Email`      |

  <Note>
    Email is the unique identifier for contacts and must always remain in two-way sync.
  </Note>
</ResponseField>

<ResponseField name="first_name" type="String">
  **First Name** — The contact's first name.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `FirstName`                                                         |
  | SF Contact Field   | `FirstName`                                                         |
</ResponseField>

<ResponseField name="last_name" type="String">
  **Last Name** — The contact's last name.

  | Property           | Value                                |
  | :----------------- | :----------------------------------- |
  | Default Sync Mode  | Prefer SF Unless Empty               |
  | Allowed Sync Modes | Prefer SF Unless Empty, Two-Way Sync |
  | Read-Only          | No                                   |
  | SF Lead Field      | `LastName`                           |
  | SF Contact Field   | `LastName`                           |

  <Warning>
    Last Name is a required field in Salesforce. Sync modes are limited to ensure this field can always be written to Salesforce.
  </Warning>
</ResponseField>

<ResponseField name="job_title" type="String">
  **Job Title** — The contact's job title or role.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Title`                                                             |
  | SF Contact Field   | `Title`                                                             |
</ResponseField>

<ResponseField name="phone" type="String">
  **Phone** — The contact's primary phone number.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Phone`                                                             |
  | SF Contact Field   | `Phone`                                                             |
</ResponseField>

<ResponseField name="mobile_phone" type="String">
  **Mobile Phone** — The contact's mobile phone number.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `MobilePhone`                                                       |
  | SF Contact Field   | `MobilePhone`                                                       |
</ResponseField>

<ResponseField name="fax" type="String">
  **Fax** — The contact's fax number.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Fax`                                                               |
  | SF Contact Field   | `Fax`                                                               |
</ResponseField>

<ResponseField name="department" type="String">
  **Department** — The contact's department within their company.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | —                                                                   |
  | SF Contact Field   | `Department`                                                        |
</ResponseField>

<ResponseField name="salutation" type="String">
  **Salutation** — The contact's salutation (Mr., Ms., Dr., etc.).

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Salutation`                                                        |
  | SF Contact Field   | `Salutation`                                                        |
</ResponseField>

<ResponseField name="date_of_birth" type="Date">
  **Date of Birth** — The contact's birth date.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | —                                                                   |
  | SF Contact Field   | `Birthdate`                                                         |
</ResponseField>

## Address Fields

<ResponseField name="street" type="String">
  **Street** — The contact's street address.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Street`                                                            |
  | SF Contact Field   | `MailingStreet`                                                     |
</ResponseField>

<ResponseField name="city" type="String">
  **City** — The contact's city. If the contact is created through a form submission, Conversion populates the city inferred from the contact's IP address.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `City`                                                              |
  | SF Contact Field   | `MailingCity`                                                       |
</ResponseField>

<ResponseField name="state" type="String">
  **State** — The contact's state or province.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `State`                                                             |
  | SF Contact Field   | `MailingState`                                                      |
</ResponseField>

<ResponseField name="postal_code" type="String">
  **Postal Code** — The contact's postal or ZIP code.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `PostalCode`                                                        |
  | SF Contact Field   | `MailingPostalCode`                                                 |
</ResponseField>

<ResponseField name="country" type="String">
  **Country** — The contact's country.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Country`                                                           |
  | SF Contact Field   | `MailingCountry`                                                    |
</ResponseField>

## Source and Status Fields

<ResponseField name="lead_source" type="String">
  **Lead Source** — How the contact originally came to you in Salesforce (from Salesforce picklist).

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `LeadSource`                                                        |
  | SF Contact Field   | `LeadSource`                                                        |
</ResponseField>

<ResponseField name="lead_status" type="String">
  **Lead Status** — The current status of the lead in Salesforce.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Status`                                                            |
  | SF Contact Field   | —                                                                   |
</ResponseField>

<ResponseField name="description" type="String">
  **Description** — Free-form description or notes about the contact.

  | Property           | Value                                                               |
  | :----------------- | :------------------------------------------------------------------ |
  | Default Sync Mode  | Prefer SF Unless Empty                                              |
  | Allowed Sync Modes | Prefer SF Unless Empty, Always Prefer SF, Two-Way Sync, Do Not Sync |
  | Read-Only          | No                                                                  |
  | SF Lead Field      | `Description`                                                       |
  | SF Contact Field   | `Description`                                                       |
</ResponseField>

<ResponseField name="owner_id" type="String">
  **Owner** — The Salesforce User ID of the record owner.

  | Property           | Value                                |
  | :----------------- | :----------------------------------- |
  | Default Sync Mode  | Two-Way Sync                         |
  | Allowed Sync Modes | Prefer SF Unless Empty, Two-Way Sync |
  | Read-Only          | No                                   |
  | SF Lead Field      | `OwnerId`                            |
  | SF Contact Field   | `OwnerId`                            |

  <Info>
    The Owner field stores the original Salesforce User ID. In the Conversion dashboard, this is displayed with additional owner information like their name and email.
  </Info>
</ResponseField>

***

## System-Managed Fields

These fields are managed by Conversion and cannot be edited manually. They track attribution and system-level data.

<ResponseField name="system_source" type="String">
  **System Source** — The system that originally created this contact record.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  Possible values:

  | Value             | Description                                   |
  | :---------------- | :-------------------------------------------- |
  | `Manual Entry`    | Created manually in the Conversion dashboard. |
  | `API Import`      | Created through the API.                      |
  | `Form Submission` | Created from a form submission.               |
  | `CSV Import`      | Created through a CSV import.                 |
  | `Salesforce`      | Created by a sync from Salesforce.            |
  | `Data Warehouse`  | Created by a sync from a data warehouse.      |
</ResponseField>

<ResponseField name="original_traffic_channel" type="String">
  **First Traffic Channel** — The traffic channel derived from the contact's first page visit.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  <Note>
    See [Traffic Channels](/product-docs/tracking/traffic-channels) for the full list of possible values.
  </Note>

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>

<ResponseField name="original_web_referrer" type="String">
  **First Web Referrer** — The referring URL of the contact's first page visit.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>

<ResponseField name="original_utm_source" type="String">
  **First UTM Source** — The `utm_source` parameter from the contact's first page visit.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>

<ResponseField name="original_utm_campaign" type="String">
  **First UTM Campaign** — The `utm_campaign` parameter from the contact's first page visit.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>

<ResponseField name="original_utm_medium" type="String">
  **First UTM Medium** — The `utm_medium` parameter from the contact's first page visit.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>

<ResponseField name="original_utm_term" type="String">
  **First UTM Term** — The `utm_term` parameter from the contact's first page visit.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | Yes                                   |
  | Mappings Editable  | Yes                                   |

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>

<ResponseField name="original_timezone" type="String">
  **Time Zone** — The contact's detected or assigned time zone. If the contact is created through a form submission, Conversion populates the timezone inferred from the contact's IP address.

  | Property           | Value                                 |
  | :----------------- | :------------------------------------ |
  | Default Sync Mode  | Always Prefer Conversion              |
  | Allowed Sync Modes | Always Prefer Conversion, Do Not Sync |
  | Read-Only          | No                                    |
  | Mappings Editable  | Yes                                   |

  <Note>
    This is a first-touch attribution field. It captures the value at contact creation and does not update on subsequent visits.
  </Note>
</ResponseField>