Skip to main content

Social Event

The SocialEvent model represents a social activity or event shared by users in the ContactsManager ecosystem. Events can represent various types of social interactions, from calendar events to posts, check-ins, and more.

Properties

Identifiers

  • id: String - Unique identifier for the event
  • organizationId: String - Organization the event belongs to
  • canonicalContactId: String - Canonical contact ID of event creator
  • userId: String? - External user ID of event creator

Event Information

  • eventType: String - Type of event (e.g., “post”, “photo”, “activity”, “check-in”)
  • title: String - Event title or main content text
  • description: String? - Optional detailed description or extended content
  • location: String? - Optional location name or address

Timing

  • startTime: Date? - When the event occurred or should be displayed from
  • endTime: Date? - Optional end time for events with duration

Visibility

  • isPublic: Bool - Whether the event is visible in public feeds

Custom Data

  • metadata: [String: String]? - Custom data specific to the event type

Creator

  • createdBy: EventCreator? - Information about who created the event

Timestamps

  • createdAt: Date - When the event was created
  • updatedAt: Date - When the event was last updated

Event Types and Metadata Examples

The eventType field combined with the metadata field allows for flexible event modeling:

Social Post

Activity Feed Item

Payment or Transaction

Location Check-in

Usage Example

Working with Event Feeds

The SDK provides several feed types for accessing events:
  • Following Feed: Events from users the current user follows
  • “For You” Feed: Public events from the wider network
  • Upcoming Events: Events scheduled in the future
  • User Events: Events created by a specific user
These feeds enable creation of rich social experiences within your app.