May 15, 2025 | 10 min read

Overview

Salesforce logo

The Eventact Salesforce Interface automatically transfers event registrants to Salesforce, ensuring each registration and ticket purchase appears as a Salesforce Contact or Lead. Sales and marketing teams can track attendee engagement directly in Salesforce without manual data transfers.

Set up the integration once in the Eventact back office to apply it across the company. Data primarily flows from Eventact to Salesforce, but you can select specific fields to read from Salesforce into Eventact. Each event can have a dedicated Salesforce Campaign, with registrants added as campaign members.

What It Can Do

CapabilityWhat happens
Find existing peopleEventact searches both Salesforce Contacts and Leads by the sync key (email, or name). If it finds both, it uses the Contact.
Update existing recordsA matched Contact or Lead is updated with the mapped Eventact fields. It stays a Contact or a Lead; Eventact never converts Leads.
Create new recordsIf no match is found, Eventact creates a new Contact or a new Lead, whichever you choose. You can also choose to create nothing and only update people who already exist in Salesforce.
Read fields backFields marked Read from Salesforce copy the Salesforce value into the Eventact registration.
Resolve conflictsFields set to Read or Write by last update time go in whichever direction is newer: Eventact wins if the registration changed last, Salesforce wins if its record changed last.
CampaignsA bulk sync finds or creates a Salesforce Campaign named after the event, and adds each synced Contact or Lead to it as a campaign member.
Custom fieldsAny custom field on the Salesforce Contact or Lead object can be mapped.
Sync triggersAutomatically after each registration, on a specific registration form page, per registrant, or in bulk for a whole event.
Status filterThe automatic sync can be limited to submitted registrants, submitted plus potential registrants, or only those who arrived at the event.

The interface supports Salesforce Contacts, Leads, Campaigns, and Campaign Members only. It does not create Accounts, Opportunities, or custom objects.

Before You Start

Eventact connects to Salesforce through a specific user account. Have the username, password, and security token for this account ready to go.

  1. Choose your integration user. You can create a new Salesforce user just for this or use an existing one. Grant only the permissions needed: read, create, and edit for Contacts and Leads, plus Campaigns and Campaign Members if you use them. Make sure API access is enabled, which comes standard with Salesforce Enterprise, Unlimited, Performance, and Developer editions.
  2. Generate the security token: a case-sensitive code that lets Eventact access the Salesforce API as your integration user.
    1. Log in to Salesforce as the integration user.
    2. Click the profile avatar and choose Settings.
    3. Select My Personal Information > Reset My Security Token.
    4. Salesforce emails the new token to the user's email address.
  3. Keep the security token up to date. Salesforce issues a new token whenever the user changes their password, invalidating the previous token. After a password change, update both the password and token in Eventact.

If your Salesforce policy allows, set a non-expiring password for the integration user. This prevents sync interruptions and avoids the dreaded "Password expired" error.

Set Up Step by Step

In the Eventact back office, open the side menu and navigate to Settings > Integrations > Salesforce. The Salesforce Settings page contains four sections.

1. Login Details

  1. Enter the integration user's username, password, and security token. The token is case-sensitive.
  2. Pick your environment: choose Production for your live Salesforce setup or Sandbox if you want to test things out first.
  3. Click Test Login. Eventact will attempt to log in using the provided credentials and display the result.
  4. Click Save. The mapping field lists will load from Salesforce only after you save your login details.

2. Options

SettingChoicesWhat it does
Sync keyEmail; First and Last NameThe value Eventact searches for in Salesforce. Email is recommended because it is unique.
Create registration asContact; Lead; NoneWhat Eventact creates when no match is found. None creates nothing and only updates people already in Salesforce.
Registrations to syncSubmitted; Submitted and Potential; ArrivedWhich registrants the automatic sync sends. Submitted includes approved registrants.
Synchronize each registrant after registrationOn / offSends each registrant to Salesforce as soon as they register.
Create a Salesforce campaign for each eventOn / offAdds registrants to a campaign named after the event.
Sync modeManual - On requestLets you sync from the registrant page or the bulk sync page.

3. Salesforce Contact Field Mapping

Match each Eventact field to its Salesforce Contact counterpart. Check the Field Mapping section below for guidance. If you create registrants as Contacts, you need at least one Contact mapping.

4. Salesforce Lead Field Mapping

Pair each Eventact field with the right Salesforce Lead field. If you create registrants as Leads, make sure to map at least one Lead field.

When you're done, click Save to lock in your settings.

Field Mapping

Each mapping row connects an Eventact token to a Salesforce field and sets the data flow direction. Pick the token on the left and the Salesforce field on the right. The Salesforce list shows every standard and custom field for Contacts or Leads.

New setups start with this default Contact mapping:

Eventact tokenSalesforce field
{Account.First Name}FirstName
{Account.Last Name}LastName
{Account.Email}Email
{Account.Title}Salutation
{Account.Organization}Company
{Account.Mobile Phone}MobilePhone

Action per Field

ActionDirection
Read or Write by last update timeBoth ways. The newer side wins.
Write to SalesforceEventact to Salesforce only.
Read from SalesforceSalesforce to Eventact only.
View data onlyNeither way. The values are shown side by side on the registrant's CRM data view.

When Eventact creates a new Contact or Lead, it sends all mapped fields for that object, regardless of their action setting.

Salesforce Contact Field Mapping in Eventact with an action set for each mapped field
Contact field mapping in the Eventact back office, with an action per field.

Country fields are sent as 2-letter ISO codes and state fields as state codes to align with Salesforce State and Country Picklists. Values read from Salesforce into Eventact menu, radio, or checkbox fields must exactly match the Eventact option text.

Find a Field's Name in Salesforce

  1. Click the gear icon in the top-right corner and select Setup.
  2. Open Object Manager.
  3. Click Contact or Lead.
  4. Click Fields & Relationships. The Field Name column shows the API name. Custom fields end in __c.
Fields and Relationships for the Contact object in Salesforce Object Manager
Fields & Relationships in Salesforce. Use the Field Name column for mapping.

Add a Custom Field

  1. In Fields & Relationships, click New.
  2. Choose the field type (Text, Picklist, Date, Checkbox, and so on) and click Next.
  3. Enter the Field Label. The Field Name fills in automatically.
  4. Click Next, and give the integration user's profile edit access to the field.
  5. Add the field to the page layouts where you want to see it, and click Save.
  6. Reopen the Salesforce Settings page in Eventact. The new field now appears in the mapping list.

Running a Sync

TriggerHow to start itStatus filter applies?
After registrationTurn on Synchronize each registrant after registration. Runs when the registrant submits the form.Yes
On a form pageIn the registration form builder, turn on Sync with CRM on Next for a page. Runs when the registrant leaves that page. See Use Salesforce Data in the Registration Form below.No
One registrantOpen the registrant's About tab, find the CRM card, and click Sync with CRM.No
Bulk, whole eventOpen the Registrants list, click the ⋮ menu, and choose CRM Sync. Then click Synchronize Now.No

The bulk sync processes all valid registrants who are new or have changed since the last sync, including imported and uploaded records. It skips in-progress, rejected, canceled, and deleted registrations. The sync runs in batches of 100 until complete.

Sync a Single Registrant

Organizers can review and re-sync individual registrants right from the back office. Go to Registration > Registrants, pick your registrant, and head to the About tab. The CRM card will show:

Two buttons act on the registrant:

The CRM card on the registrant's About tab with the Salesforce ID, last sync time, and View CRM Data showing Eventact and Salesforce values side by side
The CRM card with View CRM Data open.

This view is the most efficient way to investigate synchronization issues. Salesforce may reject values that do not match the field definition. For example, a picklist field allowing only "Pharmaceutical" and "Biotech" will reject "Pharma". Sync the registrant, review the error message, and compare the columns to identify the problematic field. Correct the value in Eventact, update the allowed values, or modify the field definition in Salesforce, then sync again.

Results

After a bulk sync completes, the page displays:

A single-registrant sync displays a one-line result, such as "Created Contact", "Updated Lead", or "Already Updated Contact".

Salesforce contacts list with registrants synced from Eventact
Contacts in Salesforce, synced from Eventact registrations.

Use Salesforce Data in the Registration Form

Page Behavior options in the form editor with Sync with CRM on Next selected

The Sync with CRM on Next page option populates a registrant's details from Salesforce during registration. Form logic can then use this data to determine which pages the registrant sees next.

A typical flow:

  1. The guest enters their email (and name) on the first page of the form and clicks Next.
  2. Eventact locates the registrant in Salesforce and copies the mapped fields into their registration, such as membership status or customer tier.
  3. Form logic on the following pages uses those values. For example, members skip the payment page, or VIP customers see a special ticket page.

To set it up:

  1. In Salesforce Settings, map each Salesforce field you need, such as a status field, to an Eventact field, with the action Read from Salesforce. Use Read from Salesforce rather than Read or Write by last update time. The registration was just saved, so Eventact counts as the newer side and would skip reading the field.
  2. Make sure the sync key field (usually email) is on the first page of the form.
  3. In the registration form editor, open the settings for the first page and enable Sync with CRM on Next.
  4. On subsequent pages, add form logic based on the Eventact fields populated from Salesforce.

This synchronization runs for every registrant who leaves the page, regardless of the Registrations to sync setting. If the guest is not found in Salesforce, the mapped Eventact fields remain empty. Form logic can check for empty values as well. For example, you can direct guests not found in Salesforce to a page that collects additional details or treat them as new prospects.

Troubleshooting

Message or symptomCause and fix
Failed to login / INVALID_LOGINThe username, password or token is wrong, or the environment is wrong. Reset the token and enter it again. Check Production vs Sandbox.
Password expiredThe integration user's Salesforce password expired. Change it, then update the password and the new token in Eventact.
Salesforce setup is incompleteThe username or token is empty. Fill in the Login Details card and save.
CRM interface for this company is not configuredSalesforce has not been set up yet. Open Settings > Integrations > Salesforce.
Failed to retrieve Salesforce contact fieldsEventact could not read the field list. Save working login details first, then reload the page.
no sync value for registrantThe registrant has no email (or name) to search by. Fill it in and sync again.
"Not existing in salesforce - read only mode not created"No match was found and Create registration as is set to None.
CRM Sync failed: …Salesforce rejected the record. The message names the reason, for example a required field that is not mapped or a validation rule.
Lead or Contact fields mapping is requiredYou chose to create Leads or Contacts but did not map any fields for that object.
INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST, or another value errorThe Salesforce field only accepts specific values, and the Eventact value is not one of them. Use View CRM Data on the registrant to find the field. Then change the value in Eventact, align the Eventact menu options with the Salesforce picklist, or add the value in Salesforce.

FAQ

Is the setup per event? No. One setup applies to all events in your company. Each event gets its own Salesforce campaign.

Can Eventact convert Leads to Contacts? No. A matched Lead stays a Lead. Convert it in Salesforce if needed.

Does it create duplicates? Eventact searches Salesforce before creating anything, and records which Salesforce record each registration was synced to. Using Email as the sync key gives the most reliable matches.

Looking for a quick answer? See the Registration FAQ: Reports, Exports, and Integrations.

Read more