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

# Contact

> Field mapping between WeGive supporters and HubSpot Contacts, including lifetime giving rollups

WeGive individual supporters sync to HubSpot Contacts.

## Identity

| WeGive field | HubSpot property | Type | Sync |
| - | - | - | - |
| `email_1` | `email` | string | ↔ |
| `email_2` | `work_email` | string | ↔ |
| `first_name` | `firstname` | string | ↔ |
| `last_name` | `lastname` | string | ↔ |
| `address_me_as` | `salutation` | string | ↔ |
| `gender` | `wegive_gender` | string | ↔ |
| `deceased` | `wegive_deceased` | boolean | ↔ |

## Contact information

| WeGive field | HubSpot property | Type | Sync |
| - | - | - | - |
| `home_phone` | `phone` | string | ↔ |
| `mobile_phone` | `mobilephone` | string | ↔ |

## Address

Which WeGive address populates HubSpot's standard address fields is controlled by **Address sync source** in [Configuration Options](/external/onboarding/hubspot/configuration-options#sync-behavior). Both addresses are always available as custom properties.

| WeGive field | HubSpot property | Sync |
| - | - | - |
| `billing_address.address_1` | `address` | ↔ |
| `billing_address.city` | `city` | ↔ |
| `billing_address.state` | `state` | ↔ |
| `billing_address.zip` | `zip` | ↔ |
| `billing_address.country` | `country` | ↔ |
| `mailing_address.address_1` | `wegive_mailing_address_line_1` | ↔ |
| `mailing_address.city` | `wegive_mailing_city` | ↔ |
| `mailing_address.state` | `wegive_mailing_state` | ↔ |
| `mailing_address.zip` | `wegive_mailing_zip` | ↔ |
| `mailing_address.country` | `wegive_mailing_country` | ↔ |

## Lifetime giving rollups (push only)

WeGive recalculates these on every transaction event and pushes them to HubSpot. They are never pulled.

| WeGive field | HubSpot property | Type |
| - | - | - |
| `donor_since` | `wegive_donor_since` | date |
| `total_given` | `wegive_total_given` | number (dollars) |
| `total_gifts` | `wegive_total_gifts` | number |
| `first_gift_date` | `wegive_first_gift_date` | date |
| `first_gift_amount` | `wegive_first_gift_amount` | number (dollars) |
| `last_gift_date` | `wegive_last_gift_date` | date |
| `last_gift_amount` | `wegive_last_gift_amount` | number (dollars) |
| `largest_gift` | `wegive_largest_gift` | number (dollars) |
| `average_gift` | `wegive_average_gift` | number (dollars) |
| `given_ytd` | `wegive_given_ytd` | number (dollars) |
| `has_active_recurring` | `wegive_is_recurring_donor` | boolean |
| `recurring_amount` | `wegive_recurring_amount` | number (dollars) |
| `donor_status` | `wegive_donor_status` | enum |

`wegive_donor_status` values: `new`, `active`, `lapsed`, `at_risk`, `churned`.

## Linkage

| WeGive field | HubSpot property | Notes |
| - | - | - |
| `id` | `wegive_id` | Stable WeGive supporter ID. Used as a secondary match key on pull, after HubSpot ID and before email. |
| `hubspot_id` | (record ID) | Stored on the WeGive supporter. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.