Sign in

Salesforce

Field Mapping

This page lists the Salesforce fields Forge reads and writes for each major object, what each one does, and our recommendation for how to set it. Use it to verify field-level security, check page layouts, or understand what changes when you edit a record in Forge.

API name convention

All custom fields listed here are prefixed with their package namespace in your org: conference360__, bt_stripe__, bt_base__ or bt_fundraising__. For example, the event start date is conference360__Event_Start_Date__c in SOQL and Apex. Labels are the Salesforce field labels; Forge shows the same labels on screens that read from your page layout.

Event (conference360__Event__c)

The Event Info tab in Forge maps to fields on conference360__Event__c in Salesforce.
The Event Info tab in Forge maps to fields on conference360__Event__c in Salesforce.
Salesforce Field Mapping
ForgeSF ObjectSF Field
Event nameconference360__Event__cName
Start dateconference360__Event__cconference360__Event_Start_Date__c
Start timeconference360__Event__cconference360__Event_Start_Time__c
End dateconference360__Event__cconference360__Event_End_Date__c
End timeconference360__Event__cconference360__Event_End_Time__c
Location type (Virtual / Venue / Hybrid)conference360__Event__cconference360__Event_Location__c
Status (Draft / Active / Canceled / Completed)conference360__Event__cconference360__Status__c
Publish (visible on public pages)conference360__Event__cconference360__Visible__c
Hide register button (set in Salesforce)conference360__Event__cconference360__Hide_Register_Button__c
Total capacityconference360__Event__cconference360__Attendee_Limit__c
Campaign linkconference360__Event__cconference360__Campaign__c
Venue name / venue Accountconference360__Event__cconference360__Venue_Name__c / conference360__Venue__c (Account lookup)
Pre-registration formconference360__Event__cconference360__Form2__c
Post-registration formconference360__Event__cconference360__Form_Post_Registration__c
Waitlist enabledconference360__Event__cconference360__Waitlist_Enabled__c
Field (Forge label)API nameType and valuesWhat it doesRecommendation
Statusconference360__Status__cPicklist: Draft, Active, Canceled, CompletedInternal status of the event. Salesforce defaults a new event to Active; Forge's create wizard saves it as Draft until you publish.Build in Draft. Set Active only when tickets, dates and location are ready, because Forge refuses to publish an event that is not Active.
Publishconference360__Visible__cCheckboxWhen checked, the event is reachable through its public event URL and appears on public groups and lists. When unchecked it is reachable only through its preview URL.Use the Publish button in Forge rather than ticking this by hand. Publishing from Forge also tells the public page to refresh.
Event Locationconference360__Event_Location__cPicklist: Virtual, Venue, HybridThe event format. Forge writes Venue when you choose In-Person, and uses the value to decide which location fields to show.Do not add or rename values. Reports and merge fields rely on these exact words.
Hide Register Buttonconference360__Hide_Register_Button__cPicklist: Yes, NoIf Yes, the registration button is hidden on the event page. Forge has no screen for this field.For an event where the planner registers every guest, set it to Yes in Salesforce (or ask an admin to add it to Event Info with Customize fields) and leave Publish unchecked if the event should not be listed.
Total Capacityconference360__Attendee_Limit__cNumberThe cap on registrations for the whole event. Salesforce re-sums it from every ticket's Quantity Available each time a ticket is created or edited; a value you enter directly can be replaced the next time a ticket is saved.To let tickets drive capacity, leave it alone and set quantities on tickets. For a hard event-wide cap, enter it after you finish ticket edits and check it again afterwards.
Time Zoneconference360__Time_Zone__cPicklist of IANA time zonesThe time zone that the event's start and end are expressed in.Set it to the venue's zone for in-person events. Salesforce computes the GMT date-time fields from it.
Campaignconference360__Campaign__cLookup (Campaign)Registrants are added to this Campaign as Campaign Members. If they were added from the Campaign first, their status is updated rather than duplicated.Link a Campaign if you report on events through Campaigns. Check that the Campaign Member status values on the Event Settings record exist on the Campaign.
Primary Event Groupconference360__Event_Group__cLookup (Event Group)The primary group for the event. Group membership itself lives on Event Group Association records.Change groups from the event's Event Group page in Forge so associations stay in step.
Event Settingsconference360__Event_Settings__cLookup (Event Settings)The shared settings record that holds checkout, visibility and display rules.Point events that should behave the same at one record. Create a separate record for an event that needs different rules.

Fields Salesforce recalculates after Forge saves

Forge writes through the normal Salesforce APIs, so triggers in the Blackthorn packages run. A save can succeed and still store a different value than the one sent. These are the cases that matter most for admins.

FieldWhat Salesforce does after the saveWhat to do
Attendee Registration StatusIf the event or ticket is at or over capacity, a status of Registered (or Pending or blank) is stored as Waitlisted - Pending, even though the save reports success.After registering or importing attendees at capacity, check the status. Raise the ticket Quantity Available or event Total Capacity first if you want them registered.
Event Total CapacityRe-summed from every ticket's Quantity Available whenever a ticket is created or edited.Finish ticket edits before you set a manual cap, and check it afterwards.
Ticket Quantity Available, Session Quantity Available, Waitlist CapacityA blank value is replaced with 999999, which means unlimited. For waitlist capacity this happens when the waitlist is switched on.Treat 999999 as unlimited. Do not report on it as a real number, and do not write it yourself.
Ticket Quantity Remaining, Session Remaining Seats, Pending CapacityRecalculated on every save.Read-only in practice. Do not write them from Flows or imports.
GMT date-time fields on events, sessions and ticket sales windowsRecomputed from the date, time and time zone fields on every save.Edit date, time and Time Zone only. Keep the GMT fields off page layouts and reports, as their own help says.
Event CurrencySet to USD when blank if your org's currency-required validation setting is off.Set Currency explicitly on any event that is not in USD.
Event GroupEvent Group Association records are created and removed automatically. Writing the field blank can re-fill it from another group the event still belongs to.Change group membership on the event's Event Group page, or delete the association record, instead of clearing the field.
Attendee First Name, Last Name, Email and PhoneThe package copies between the older fields and the newer First Name, Last Name, Email and Phone fields whenever one is blank.Use the non-deprecated fields (the ones without (Deprecated) in the label) in new reports and Flows.
Attendee SourceStamped Web App on an insert through the API when blank.Use Source to separate Forge-created attendees from imports and Salesforce UI entries.
Attendee Event DescriptionOverwritten from the event's Description every time the attendee is saved.Do not use it for notes. Edit the event's Description instead.
Invoice Net Amount, Subtotal, Total Amount and Discount AmountRolled up from the invoice's line items. A value written directly on an invoice with no line items is stored as 0.Edit line items, not the totals.

Session (conference360__Session__c)

Salesforce Field Mapping
ForgeSF ObjectSF Field
Session nameconference360__Session__cName
Parent eventconference360__Session__cconference360__Event__c
Start date/timeconference360__Session__cconference360__Start_Date__c / conference360__Start_Time__c
End date/timeconference360__Session__cconference360__End_Date__c / conference360__End_Time__c
Roomconference360__Session__cconference360__Room_Lookup__c (lookup) / conference360__Room_Text__c (free text, labeled Location)
Capacity (Quantity Available)conference360__Session__cconference360__Maximum_Registrants__c
Waitlist enabledconference360__Session__cconference360__Waitlist_Enabled__c
Status (Draft / Active / Canceled / Postponed / Completed)conference360__Session__cconference360__Status__c
Audience visibility (Member / Non-Member / VIP / Press)conference360__Session__cconference360__Visibility_Control__c
Session type / topicconference360__Session__cconference360__Type__c / conference360__Topic__c
Descriptionconference360__Session__cconference360__Description__c
Field (Forge label)What it doesRecommendation
Quantity Available (Maximum Registrants)The most registrants the session can hold. The older Capacity field is deprecated.Set it to the room size. Leave blank for unlimited.
StatusSalesforce's help text says to set it to Active for the session to be visible.If a session is missing from an agenda, check Status and its start date before anything else.
Visibility ControlShows or hides the session by matching the Contact's Visibility Control value.Use it for member-only or VIP-only sessions; the Contact needs a matching value.
Location (Room_Text)Free-text room or directions. Separate from the Room lookup, which picks a room from the org's room library.Use the lookup if you share rooms across events, free text otherwise.

Ticket / Item (conference360__Event_Item__c)

Salesforce Field Mapping
ForgeSF ObjectSF Field
Item nameconference360__Event_Item__cconference360__Item_Name__c (Public Item Name)
Parent eventconference360__Event_Item__cconference360__Event__c
Priceconference360__Event_Item__cconference360__Price__c
Free ticket (no charge)conference360__Event_Item__cconference360__Free__c
Type (Main event ticket / Donation / Guest / Other)conference360__Event_Item__cconference360__Type__c
Status (Planned / On Sale / Sold Out / Closed / Unavailable)conference360__Event_Item__cconference360__Status__c
Quantity availableconference360__Event_Item__cconference360__Quantity_Made_Available__c
Sold quantity (Registered)conference360__Event_Item__cconference360__Sold_Quantity__c
Registration formconference360__Event_Item__cconference360__Form__c
Sales start dateconference360__Event_Item__cconference360__Sales_Start_Date__c
Sales end dateconference360__Event_Item__cconference360__Sales_End_Date__c
Sort orderconference360__Event_Item__cconference360__Sort_Order__c
Visibility ruleconference360__Event_Item__cconference360__Visibility_Rule__c
Field (Forge label)What it doesRecommendation
StatusSalesforce's help text says to set it to On Sale when you are ready for people to purchase. Forge's ticket list shows a calculated Open, Sold out or Closed pill, which is separate.Keep Planned while you configure, then set On Sale at launch. Use Unavailable to pull a ticket without deleting it.
FreeMarks the ticket as free; no Price is needed.Tick Free for free tickets instead of relying on a price of 0.
Quantity AvailableThe number of this ticket you can sell. Blank is stored as 999999 (unlimited).Set it for every capped tier. It also feeds the event's Total Capacity.
HiddenHides the item from event checkout.Use for tickets that should not be offered in public checkout.
Maximum QuantityThe most of this ticket one person can add to a cart.Set to 1 for one-per-person tickets.

Attendee (conference360__Attendee__c)

PII on this object

conference360__Attendee__c stores the attendee's name, email and phone, and joins to a Contact or Lead. Forge fetches these fields just in time and keeps names, emails and phones out of its database cache. Make sure field-level security lets only authorized users read them.

Salesforce Field Mapping
ForgeSF ObjectSF Field
First nameconference360__Attendee__cconference360__First_Name2__c
Last nameconference360__Attendee__cconference360__Last_Name2__c
Emailconference360__Attendee__cconference360__Email2__c
Phoneconference360__Attendee__cconference360__Phone2__c
Parent eventconference360__Attendee__cconference360__Event__c
Ticketconference360__Attendee__cconference360__Event_Item__c
Registration statusconference360__Attendee__cconference360__Registration_Status__c
Attendance statusconference360__Attendee__cconference360__Attendance_Status__c
Contact linkconference360__Attendee__cconference360__Contact__c
Lead linkconference360__Attendee__cconference360__Lead__c
Waitlist recordconference360__Attendee__cconference360__Waitlist__c
Check-in timestampconference360__Attendee__cconference360__Checked_In_At__c
Invoice (Sales Document)conference360__Attendee__cconference360__Sales_Document__c
Registration date/timeconference360__Attendee__cconference360__Registration_DateTime__c
Companyconference360__Attendee__cconference360__Company__c
Titleconference360__Attendee__cconference360__Title__c

The older conference360__First_Name__c, Last_Name__c and Email__c fields still exist but are labeled (Deprecated). Forge reads and writes the newer fields; the package keeps the pairs in step when one is blank.

Registration Status valueMeaningAdmin note
LeadProspect, not yet invited or registered.A prospect attendee record, usually linked to a Lead rather than a Contact.
To InviteQueued for an invitation email.Use as the audience for your first invitation send.
InvitedInvitation sent; awaiting a response.
PendingRegistration started but not complete.Registration in progress or waiting on a step such as payment. Review old Pending records before the event.
RegisteredSuccessfully registered.Counts toward capacity. Registration Date/Time is set when the status becomes Registered.
Waitlisted - PendingOn the waitlist; no seat yet.Salesforce sets this automatically at capacity. Join time is stamped automatically.
Waitlisted - RejectedWaitlist spot was not offered or was declined.
Awaiting ApprovalSubmitted; needs manual approval.
RejectedReviewed and rejected.
DeclinedExplicitly declined the invitation.
CanceledRegistration canceled by the planner or attendee.Frees the seat; with Waitlisting: Automate on, the next waitlisted attendee moves to Pending.

Attendance Status is a separate field: Pending (default), Attended or No-Show. Checking someone in with the mobile app sets Attended automatically; Forge's check-in portal also stamps Checked In At.

Speaker (conference360__Speaker__c)

Salesforce Field Mapping
ForgeSF ObjectSF Field
Speaker nameconference360__Speaker__cconference360__Speaker_Full_Name__c
Parent eventconference360__Speaker__cconference360__Event__c
First name / Last nameconference360__Speaker__cconference360__First_Name__c / conference360__Last_Name__c
Bioconference360__Speaker__cconference360__Bio_Rich__c
Titleconference360__Speaker__cconference360__Title__c
Company (Account)conference360__Speaker__cconference360__Company__c
Status (Planned / Invited / Confirmed / Attended / Declined / Canceled / No Show)conference360__Speaker__cconference360__Status__c
Visibility (Featured / Shown on Listing / Hidden)conference360__Speaker__cconference360__Speaker_Visibility__c
Emailconference360__Speaker__cconference360__Email__c
Websiteconference360__Speaker__cconference360__Website__c
Linked Contactconference360__Speaker__cconference360__Contact__c

Recommendation: Salesforce's help text for Status says to select Confirmed when you are ready to show the speaker on your event link. Keep speakers you have not announced at Planned or Invited and set Speaker Visibility to Hidden.

Sponsor (conference360__Sponsor__c)

Salesforce Field Mapping
ForgeSF ObjectSF Field
Sponsor nameconference360__Sponsor__cName
Parent eventconference360__Sponsor__cconference360__Event__c
Tier / Level (Platinum / Gold / Silver / Bronze)conference360__Sponsor__cconference360__Tier__c
Status (Planned / Invited / Confirmed / Declined)conference360__Sponsor__cconference360__Status__c
Linked Accountconference360__Sponsor__cconference360__Account__c
Sponsor representative (Contact)conference360__Sponsor__cconference360__Sponsor_Representative__c
Primary contact emailconference360__Sponsor__cconference360__Primary_Contact_Email__c
Websiteconference360__Sponsor__cconference360__Website__c
Descriptionconference360__Sponsor__cconference360__Bio_Rich__c

Form (conference360__Form__c)

Salesforce Field Mapping
ForgeSF ObjectSF Field
Form nameconference360__Form__cName
Form type (Pre-registration / Post-registration / Survey)conference360__Form__cconference360__Type__c
Form URLconference360__Form__cconference360__Form_URL__c
Question (Form Element)conference360__Form_Element__cconference360__Question__c
Question typeconference360__Form_Element__cconference360__Type__c
Maps to Salesforce objectconference360__Form_Element__cconference360__Maps_To_Object__c
Maps to Salesforce fieldconference360__Form_Element__cconference360__Maps_To_Field__c
Requiredconference360__Form_Element__cconference360__Required__c
Sort orderconference360__Form_Element__cconference360__Sort_Order__c
Submission status (In Progress / Submitted / Error)conference360__Form_Submission__cconference360__Status__c
Answerconference360__Form_Submission_Answer__cconference360__Answer__c / conference360__Answer_Text_Long__c / conference360__Answer_Number__c / conference360__Answer_Date__c

Recommendation: when you map a question to Salesforce, map identity questions to Contact rather than to the attendee's first name, last name or email, and choose a target field whose type matches the question type.

Discount Code (bt_stripe__Code__c)

Salesforce Field Mapping
ForgeSF ObjectSF Field
Code namebt_stripe__Code__cName
Code purpose (Discount / Access-Promo / Source)bt_stripe__Code__cbt_stripe__Type__c
Discount amountbt_stripe__Code__cbt_stripe__Discount_Amount__c
Discount percentagebt_stripe__Code__cbt_stripe__Discount_Percentage__c
Max uses (Quantity Made Available)bt_stripe__Code__cbt_stripe__Quantity_Available__c
Uses remainingbt_stripe__Code__cbt_stripe__Quantity_Remaining__c
Valid from datebt_stripe__Code__cbt_stripe__Valid_From__c
Valid through datebt_stripe__Code__cbt_stripe__Valid_Through__c
Restrict to Accountbt_stripe__Code__cbt_stripe__Restrict_To_Account__c
FieldWhat it doesRecommendation
TypeDiscount lowers the price. Access-Promo gives access to buy an item or a promotional benefit. Source is a tracking code that follows a visitor through a flow, such as an embedded URL.Use Discount for price promotions, Access-Promo to gate a ticket, and Source for campaign tracking.
Quantity Made AvailableHow many times the code can be used. Blank means unlimited. Remaining is calculated from claimed uses.Cap promotional codes. Leave blank only for standing codes.
Valid From / Valid ThroughThe code works only inside this date range.Always set Valid Through on promotions.
Restrict To AccountOnly Contacts associated with this Account can use the code.Use for partner or member-organization codes.

Transaction (bt_stripe__Transaction__c)

No card data stored

bt_stripe__Transaction__c does not hold card numbers, CVVs or full card details. Sensitive payment instrument data is held only by the payment gateway. Forge reads the transaction status and amount and never surfaces raw card values.

Salesforce Field Mapping
ForgeSF ObjectSF Field
Amountbt_stripe__Transaction__cbt_stripe__Amount__c
Transaction statusbt_stripe__Transaction__cbt_stripe__Transaction_Status__c
Payment statusbt_stripe__Transaction__cbt_stripe__Payment_Status__c
Currencybt_stripe__Transaction__cbt_stripe__Currency_ISO__c
Gateway referencebt_stripe__Transaction__cbt_stripe__Customer_Id__c / bt_stripe__Authorization_Code__c
Parent Sales Documentbt_stripe__Transaction__cbt_stripe__Sales_Document__c
Contact (first name)bt_stripe__Transaction__cbt_stripe__Contact_First_Name__c
Contact (last name)bt_stripe__Transaction__cbt_stripe__Contact_Last_Name__c
FieldWhat it doesRecommendation
Transaction StatusControls the transaction's business logic: Open, Process, Pending, Pending Payment Intent, Completed, On Hold, Canceled, Needs Review or Failed.Do not set a Transaction to Process by hand: that starts a charge through the gateway.
Payment StatusThe state of the funds (for example Authorized, Captured, Refunded, Partially Refunded). It applies only once Transaction Status is Completed.Report on Transaction Status first, then Payment Status for refunds and disputes.