Salesforce
Object Correlation
Forge maps every concept in its UI to a Salesforce object. When your org connects, Forge reads which Blackthorn objects are installed and records a per-org object map. If an expected object is not installed, Forge shows an "Object not mapped" notice rather than guessing.
Namespace conventions
Events objects use the conference360__ namespace. Payments objects use bt_stripe__. Base (visibility rules, translations, scheduling) uses bt_base__. Fundraising (donations, auctions) uses bt_fundraising__. Standard Salesforce objects (Contact, Lead, Campaign, CampaignMember, Account) are used directly without a namespace prefix.
Events: conference360__ namespace
| Forge concept | Salesforce object | Notes |
|---|---|---|
| Event | conference360__Event__c | Top-level record, one per event. Holds dates, time zone, Event Location (Virtual, Venue or Hybrid), Status (Draft, Active, Canceled, Completed), Publish (Visible), Total Capacity and waitlist settings, and lookups to its Event Settings, Event Group and Campaign. |
| Event Settings | conference360__Event_Settings__c | Checkout, visibility, language, waitlist-automation and public-page display rules. Many events can point at one Event Settings record, so editing it changes every event that uses it. |
| Session | conference360__Session__c | Child of Event through its Event lookup. Models a breakout, workshop or time slot. Capacity is Quantity Available (Maximum_Registrants__c); the older Capacity field is deprecated. |
| Ticket / Item | conference360__Event_Item__c | Child of Event. Covers tickets, donation items, guest tickets and add-on products, controlled by the Type picklist (Main event ticket, Donation, Guest, Other). Status is Planned, On Sale, Sold Out, Closed or Unavailable. |
| Ticket-to-session link | conference360__Event_Item_Session__c | Junction that links a ticket to a session it includes. Holds Required, Price and Free for that ticket and session pair. |
| Attendee | conference360__Attendee__c | One record per person per event registration. Linked to a Contact or Lead through separate lookups. Holds Registration Status, Attendance Status (Pending, Attended, No-Show), Checked In At and the invoice it belongs to. |
| Session Attendee | conference360__Session_Attendee__c | Junction between an Attendee and a Session; tracks per-session enrollment. Master-Detail to both, so deleting a Session or Attendee deletes these links. |
| Speaker | conference360__Speaker__c | Child of Event. Profile record for a speaker: bio, title, company, status and visibility. |
| Session Speaker | conference360__Session_Speaker__c | Junction linking a Speaker to a Session. Master-Detail to both. |
| Sponsor | conference360__Sponsor__c | Child of Event. Holds tier, status, the sponsor's Account and a Sponsor Representative (Contact). |
| Form | conference360__Form__c | Registration, post-registration or survey form definition (Type: Pre-registration, Post-registration or Survey). Its questions are conference360__Form_Element__c records. |
| Form Submission | conference360__Form_Submission__c | One record per submitted form, with Status In Progress, Submitted or Error. Each answer is a conference360__Form_Submission_Answer__c child. |
| Event Group | conference360__Event_Group__c | Groups events into a series for a shared public listing and branding. |
| Event Group Association | conference360__Event_Group_Association__c | Links an event to each group it belongs to. An event belongs to many groups but has one primary group, set on the event's Primary Event Group lookup. |
| Budget Expense | conference360__Budget_Expense__c | Line-item budget and expense tracking under an Event. |
| Audience (Segment) | conference360__Attendee__c (filtered) | Segments are filters over Attendee records. Forge stores snapshot members as Salesforce IDs, plus a company name for business contacts. |
| Campaign link | Campaign (standard) | An Event links to a Campaign through its Campaign lookup. Registrants are added as Campaign Members, or their existing member status is updated, never duplicated. |
Payments: bt_stripe__ namespace
| Forge concept | Salesforce object | Notes |
|---|---|---|
| Invoice / Order | bt_stripe__Sales_Document__c | Summarizes a registrant's purchase. Status is one of Draft, Sent, Accepted, Completed, Rejected, Voided, Ready To Bill or Uncollectible. A separate Payment Status (Unpaid, Past Due, Partially Paid, Paid, Refunded, Partially Refunded, Overpaid) is set automatically. |
| Transaction | bt_stripe__Transaction__c | One payment attempt. Transaction Status is Open, Process, Pending, Pending Payment Intent, Completed, On Hold, Canceled, Needs Review or Failed. A separate Payment Status (Authorized, Captured, Refunded and so on) tracks the funds and applies only once the transaction is Completed. Forge does not store raw card data. |
| Discount Code | bt_stripe__Code__c | Type is Discount, Access-Promo or Source. Holds a Discount Amount or Discount Percentage, Quantity Made Available and Remaining, Valid From and Valid Through dates, and an optional Restrict To Account. |
| Fee | bt_stripe__Fee__c | A percentage fee applied to an event's orders. Type is Payment Processing or Tax. |
| Payment Gateway | bt_stripe__Payment_Gateway__c | Org-level gateway configuration. Provider is Stripe, Spreedly, Authorize.net, PayPal, TouchNet or CashNet. The credentials for the gateway live on this record in your org; Forge's screens only show whether a gateway is connected. |
Base: bt_base__ namespace
| Forge concept | Salesforce object | Notes |
|---|---|---|
| Visibility Rule | bt_base__Rule__c | Defines who can see or buy an item. Condition Type is AND, OR or Custom. Conditions are child bt_base__Rule_Condition__c records. |
| Rule Condition | bt_base__Rule_Condition__c | One condition (field, operator, value, order) on a rule. Its lookup to the rule is Restrict, so a rule with conditions cannot be deleted until the conditions are removed. |
| Translation | bt_base__Translation__c | Translated text for labels and content. |
Forms objects
Base also ships its own bt_base__Form__c, bt_base__Form_Submission__c and related form objects. Registration, post-registration and survey forms in Forge use the Events versions (conference360__Form__c, conference360__Form_Element__c, conference360__Form_Submission__c and conference360__Form_Submission_Answer__c). Build reports on those, not on the Base form objects.
Admin recommendations
| To achieve... | Do this | Why |
|---|---|---|
| A report of registrations by ticket | Report on conference360__Attendee__c and group by its Ticket (Event Item) lookup, filtered by Registration Status = Registered. | Each registration is one Attendee record and it points at the ticket that was purchased. |
| Revenue reporting | Report on bt_stripe__Sales_Document__c (invoices) for what was billed and bt_stripe__Transaction__c for payments. | An invoice is what is owed; a Transaction is a payment attempt. Filter Transactions to Transaction Status = Completed to count money received, then use Payment Status to separate refunds. |
| A series report across events | Report on conference360__Event_Group_Association__c, which lists every event and group pair, rather than on the event's primary group field. | The primary group lookup holds only one group; the association records hold every group the event belongs to. |
| Hide a ticket from some people | Use a Visibility Rule on the ticket, not a duplicate ticket. | Rules are reusable across tickets and sessions. |
| Delete a Visibility Rule or an Event Group | Remove the rule's conditions, or the group's event associations, first. | Their child lookups are set to Restrict, so Salesforce refuses the delete while children exist. |
Fundraising — bt_fundraising__ namespace (Beta)
| Forge concept | Salesforce object | Notes |
|---|---|---|
| Donation | bt_fundraising__Donation__c | A single giving transaction. Holds amount, designation, frequency, donor contact/account, and gateway transaction ID. |
| Recurring Gift | bt_fundraising__Recurring_Gift__c | A recurring donation schedule — cadence, amount, next payment date. Driven by Forge's own recurrence engine, never by Stripe Subscriptions. |
| Pledge | bt_fundraising__Pledge__c | A donor commitment to give over time, tracked against fulfilment. |
| Designation | bt_fundraising__Designation__c | Fund bucket that a donation amount is allocated to. |
| Auction | bt_fundraising__Auction__c | An auction event. Type__c indicates Live, Silent, or Timed. |
| Auction Item | bt_fundraising__Auction_Item__c | A lot within an Auction. Holds title, starting bid, reserve, and fair market value. |
| Bid | bt_fundraising__Bid__c | An individual bid placed on an Auction Item. |
| Auction Registration | bt_fundraising__Auction_Registration__c | Registers a bidder to participate in an Auction. |
| P2P Participant | bt_fundraising__P2P_Participant__c | A peer-to-peer fundraising participant record. |
| P2P Team | bt_fundraising__P2P_Team__c | A peer-to-peer fundraising team. |
All packaged objects
Every custom object in the Blackthorn Events, Payments, Base and Fundraising packages (164 objects). Custom settings and Stripe Subscription objects are left out — Forge does not use them.
164 objects
| Object | API name | Description |
|---|---|---|
| Branding Setting | bt_base__Branding_Setting__c | |
| BT Form (Deprecated) | bt_base__Form__c | This object was deprecated and has been moved to the Events package. |
| BT Form Big List Group (Deprecated) | bt_base__Form_Big_List_Group__c | This object was deprecated and has been moved to the Events package. |
| BT Form Big List Option (Deprecated) | bt_base__Form_Big_List_Option__c | This object was deprecated and has been moved to the Events package. |
| BT Form Element (Deprecated) | bt_base__Form_Element__c | This object was deprecated and has been moved to the Events package. |
| BT Form Element Condition (Deprecated) | bt_base__Form_Element_Condition__c | This object was deprecated and has been moved to the Events package. |
| BT Form Submission (Deprecated) | bt_base__Form_Submission__c | This object was deprecated and has been moved to the Events package. |
| BT Form Submission Answer (Deprecated) | bt_base__Form_Submission_Answer__c | This object was deprecated and has been moved to the Events package. |
| BT Keyword | bt_base__Keyword__c | |
| BT Rule | bt_base__Rule__c | Parent of rule conditions records. Rules dictate the website visitor’s visibility of and access to events, event items, sessions, products, and more. |
| BT Rule Condition | bt_base__Rule_Condition__c | Contains an individual field reference, a function, and a value. Rule conditions are combined by rules, which dictate the website visitor’s visibility of and access to events, event items, sessions, products, and more. |
| Schedule | bt_base__SCH_Schedule__c | |
| Schedule Action | bt_base__SCH_Schedule_Action__c | |
| Schedule Delta Request | bt_base__SCH_Schedule_Delta_Request__c | Used to store Delta Request details when API fails, so that process can attempt to retry those. |
| Schedule Execution | bt_base__Schedule_Execution__c | |
| Schedule Execution Log | bt_base__Schedule_Execution_Log__c | |
| Translation | bt_base__Translation__c | |
| Visibility Rule | bt_base__Visibility_Rule__c | |
| Auction | bt_fundraising__Auction__c | Represents a live, silent, timed, or raffle auction event within Blackthorn Auctions. Tracks auction configuration, scheduling, and aggregate metrics. |
| Auction Appeal | bt_fundraising__Auction_Appeal__c | Represents a Fund-a-Need or paddle-raise appeal within a live auction. An appeal is a live fundraising ask where bidders raise paddles to donate at a specific giving level. Multiple appeals can exist per auction. |