Skip to main content
This page explains the core entities in Trackly SMS and how they relate to each other.

​
Entity Overview

Account (root tenant)
├── SendingList (phone number + config)
│   └── ListContact (subscription state)
│       └── Contact (global phone record)
├── Audience (segment definition)
├── Schedule (campaign)
├── MessageCreative (template)
├── WelcomeJourney (automation)
├── Offer (affiliate offer)
└── User (team member)

​
Account

The Account is your organization’s workspace. It’s the root container for all your data.
FieldDescription
NameOrganization name
Owner emailPrimary contact
Statusactive, suspended, deleted
SettingsMessaging config, bot filtering
One user can access multiple accounts with different roles.

​
SendingList

A SendingList represents a phone number configuration.
FieldDescription
Phone numberThe “from” number
ProviderInfobip, Twilio, etc.
Brand nameDisplay name
CredentialsProvider-specific config
Statusactive, inactive
Contacts subscribe to lists. Messages are sent from lists.

​
Contact

A Contact is a global phone number record. The same phone number exists once across the system.
FieldDescription
Phone numberE.164 format
CarrierDetected carrier
Line typecell, VOIP, landline
TimezoneDerived from area code

​
ListContact

A ListContact connects a Contact to a SendingList—the subscription relationship.
FieldDescription
Statusactive, unsubscribed
Signup dateWhen they joined
Signup methodAPI, import, form
Custom fieldsAccount-defined data
Activity statsDenormalized metrics
Activity stats include:
  • last_sent_at, last_clicked_at
  • send_count, click_count
  • revenue_total, conversion_count

​
Audience

An Audience defines a segment of contacts using filter conditions.
FieldDescription
NameDisplay name
ListsWhich lists to query
ConditionsFilter rules
Cached sizeEstimated count
Audiences contain AudienceGroups with AudienceConditions for AND/OR logic.

​
Schedule

A Schedule is a campaign configuration.
FieldDescription
NameCampaign name
Sending listWhich number to send from
AudiencesWho to target
Send typeblast, automated
Schedule configOne-time, recurring
Schedules contain ScheduleBlasts (message variants with offers).

​
MessageCreative

A MessageCreative is a reusable message template.
FieldDescription
BodyMessage text with placeholders
Offer bindingsLink → Offer mappings
Typeone_time, automated, welcome
Statusactive, paused, archived
PerformanceSends, clicks, revenue

​
WelcomeJourney

A WelcomeJourney is an automated sequence.
FieldDescription
NameJourney name
Trigger conditionsWhen to enroll
Statusdraft, active, paused
Journeys contain JourneySteps (send, wait, condition, exit). JourneyEnrollment tracks each contact’s progress through a journey.

​
Offer

An Offer represents an affiliate offer.
FieldDescription
NameOffer name
Tracking URLDestination
PayoutCPA/CPC amount
SourceTUNE, manual, etc.
PerformanceClicks, conversions

​
MessageSent

A MessageSent records each sent message.
FieldDescription
ContactWho received it
CreativeWhat template
Sending listFrom number
ScheduleCampaign source
Statusqueued, sent, delivered, failed
A MessageShortLink is a tracked URL in a message.
FieldDescription
Link IDShort code (7 chars)
DestinationOriginal URL
OfferAssociated offer
MessageShortLinkClick logs each click event.

​
User

A User is a person with dashboard access.
FieldDescription
EmailLogin email
StatusActive, pending
AccountsList of accessible accounts
AccountAccess defines role per account (Owner, Member, Viewer).

​
Relationships Diagram

                    ┌─────────────┐
                    │   Account   │
                    └──────┬──────┘
         ┌─────────────────┼─────────────────┐
         ▼                 ▼                 ▼
   ┌───────────┐    ┌───────────┐    ┌───────────┐
   │SendingList│    │  Schedule │    │  Audience │
   └─────┬─────┘    └─────┬─────┘    └───────────┘
         │                │
         ▼                ▼
   ┌───────────┐    ┌───────────┐
   │ListContact│    │ScheduleBlast│
   └─────┬─────┘    └─────┬─────┘
         │                │
         ▼                ▼
   ┌───────────┐    ┌───────────┐
   │  Contact  │    │  Creative │
   └───────────┘    └─────┬─────┘
                          │
                          ▼
                    ┌───────────┐
                    │   Offer   │
                    └───────────┘

​
Next Steps

Message Lifecycle

How messages flow through the system

Compliance

Opt-out and regulations