MngEvent

Represents the details of a managed event. This object is available in API version 67.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

AccountId

  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: The ID of the account that populates when the Event Location is set to an Account.

    This field is a relationship field.

  • Relationship Name: Account
  • Refers To: Account

AddressId

  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: The address that populates when Event Location Address references an Address record.

    This field is a relationship field.

  • Relationship Name: Address
  • Refers To: Address

CampaignId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The campaign associated with the managed event.

    This field is a relationship field.

  • Relationship Name: Campaign
  • Refers To: Campaign

Capacity

  • Type: int
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Primary participant limit for the event; up to this number, registrations are accepted as Registered.

CapacityEnforcementType

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: The registration behavior when event capacity is reached.
  • Possible values:
    • NoCapacityCheck—No Capacity Check
    • NoWaitlist—No Waitlist
    • Overbooking
    • Waitlist

CapacityStatus

  • Type: string
  • Properties: Filter, Group, Nillable, Sort
  • Description: Indicates real-time registration availability based on the current participant count.

    This field is a calculated field.

  • Possible values:
    • Available—Under 80% full.
    • NearCapacity—Between 80% and 100% full.
    • Full—Capacity has been reached and registration enforcement is strict (no waitlist enabled).
    • WaitlistOnly—Capacity has been reached but waitlist registration is available based on enforcement settings.
    • Closed—Registration has ended.

CheckinEndDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the date and time when event check-in closes.

CheckinStartDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the date and time when event check-in begins.

ComplianceAgreementStatus

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Specifies the status of the compliance agreement for the managed event.
  • Possible values:
    • Agreed
    • AgreementOptional
    • AgreementRequired
    • NotRequired

ComplianceStatements

  • Type: textarea
  • Properties: Create, Nillable, Update
  • Description: The compliance statements contain the details of the policies and procedures that must be adhered to for the managed event.

ContactPointAddressId

  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: The address that populates when Event Location Address references a Contact Point Address record.

    This field is a relationship field.

  • Relationship Name: ContactPointAddress
  • Refers To: ContactPointAddress

CurrentRegistrationCount

  • Type: int
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Live count of active participants in the event, including registered and waitlisted participants.

CurrentUserEventRole

  • Type: string
  • Properties: Filter, Group, Nillable, Sort
  • Description: The role of the current user who is viewing the record in the managed event.

CurrentWaitlistCount

  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Description: Current number of waitlisted participants, derived from registrations above capacity.

    This field is a calculated field.

DefaultInvitationQuota

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The default invitation quota assigned to colleagues when a managed event is created.

Description

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The description of the managed event.

EndDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The date and time until which the managed event is scheduled.

EstimatedBudget

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The total estimated cost for organizing the event, based on expected expenses such as venue, travel, speaker fees, logistics, and other resources.

EstimatedParticipantCount

  • Type: int
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The estimated number of participants expected to attend the managed event.

EventLocationAddressId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The physical address of the event.

    This field is a polymorphic relationship field.

  • Relationship Name: EventLocationAddress
  • Refers To: Address, ContactPointAddress

EventLocationId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the location or account where the event is held. This field serves as the primary source for all derived location details and geographic mapping.

    This field is a polymorphic relationship field.

  • Relationship Name: EventLocation
  • Refers To: Account, Location

EventMgmtStatusId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the type of managed event.

    This field is a relationship field.

  • Relationship Name: EventMgmtStatus
  • Refers To: EventMgmtStatus

EventPlanId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The broader event plan to which the event belongs to. An event plan streamlines tracking, budgeting, and reporting about the planned and executed events.

    This field is a relationship field.

  • Relationship Name: EventPlan
  • Refers To: EventPlan

EventStructure

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: The structure of the managed event.
  • Possible values:
    • Host
    • Satellite
    • Standalone

HardRegistrationLimit

  • Type: int
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Absolute maximum total registrations for the event, including registered and waitlisted participants.

IsAutoWaitlistProcEnabled

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Specifies whether waitlisted participants are automatically promoted when capacity becomes available.
  • Default value: false

IsSatelliteRegistrationOpen

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates if satellite registration is open for the host managed event.
  • Default value: false

LastReferencedDate

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.

LastViewedDate

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The timestamp when the current user last viewed this record or list view.

    If this value is null, and LastReferenceDate isn’t null, the user accessed this record or list view indirectly.

LocationId

  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: The ID of the location where the manged event is hosted.

    This field is a relationship field.

  • Relationship Name: Location
  • Refers To: Location

LocationType

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Indicates the event location type, such as in-office or out-of-office.
  • Possible values:
    • CompanyLocation
    • CustomerLocation
    • PartnerLocation
    • ThirdPartyLocation

MaximumAllowedSatellites

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The maximum number of satellite registrations allowed for the host managed event.

MngEventDefinitionId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ID of the managed event definition associated with the managed event.

    This field is a relationship field.

  • Relationship Name: MngEventDefinition
  • Refers To: MngEventDefinition

MngEventTypeId

  • Type: reference
  • Properties: Create, Filter, Group, Sort, Update
  • Description: Required. The ID of the managed event type associated with the managed event.

    This field is a relationship field.

  • Relationship Name: MngEventType
  • Refers To: MngEventType

Mode

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Specifies the mode in which the managed event is delivered.
  • Possible values:
    • Hybrid
    • InPerson
    • RemoteEngagement
    • Virtual

Name

  • Type: string
  • Properties: Create, Filter, Group, idLookup, Sort, Update
  • Description: The name of the managed event.

OnlineAccessCode

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The access code required to join the online event.

OnlineIdentifier

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The identifier for the virtual event session.

OnlineUrl

  • Type: url
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The web link for participants to join the online event.

OwnerId

  • Type: reference
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: ID of the owner of this record.

    This field is a polymorphic relationship field.

  • Relationship Name: Owner
  • Refers To: Group, User

ParentId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The main overarching event that serves as the primary source of authority for related smaller events.

    This field is a relationship field.

  • Relationship Name: Parent
  • Refers To: MngEvent

PrimaryOwnerId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ID of the suser who is the primary owner of the managed event.

    This field is a relationship field.

  • Relationship Name: PrimaryOwner
  • Refers To: User

RegistrationEndDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the date and time when registration closes.

RegistrationStartDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the date and time when registration opens.

SatelliteCount

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The total number of related satellite managed events.

SatelliteDiscrepancyReason

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: The specific reason or error that explains the discrepancy detected during satellite event creation.
  • Possible values:
    • AddedAfterRegistrationClosed
    • MaxSatelliteLimitReached

SourceSystem

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The name of the external system that generated the record.

SourceSystemIdentifier

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ID of the record in the external system.

StartDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The date and time from which the managed event is scheduled.

Status

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the status of the managed event.
  • Possible values:
    • Completed
    • New
    • Pending

StatusUsedInBudgetCalculation

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The status of the managed event at the time of the last budget calculation.

TotalActualExpenseAmount

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The sum of actual expense amounts incurred for the event.

TotalBudgetAmount

  • Type: currency
  • Properties: Filter, Nillable, Sort
  • Description: The sum of all budgets associated with the event.

    This field is a calculated field.

TotalEstimatedExpenseAmount

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The sum of estimated expense amounts associated with the event.

Url

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The URL of the webpage that contains the details of the managed event.

WaitlistProcessingEndDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the date and time when waitlist processing stops.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

MngEventChangeEvent
Change events are available for the object.
MngEventFeed
Feed tracking is available for the object.
MngEventHistory
History is available for tracked fields of the object.
MngEventShare
Sharing is available for the object.