Core Concepts

Understanding FluxCascade's key concepts will help you build effective integrations.

Connections

A Connection represents an authenticated link to an external system like HubSpot, Jobber, or Salesforce.

• Each connection stores OAuth tokens securely (encrypted at rest)
• Tokens are automatically refreshed before expiry
• You can connect multiple accounts of the same platform (multi-portal support)

interface Connection {
  id: string;
  provider: 'hubspot' | 'jobber' | 'pipedrive' | 'salesforce';
  status: 'active' | 'expired' | 'error';
  accountName: string;
  createdAt: string;
}

Mappings

A Mapping defines how data flows between two systems. It specifies:

• Source: Where data comes from (provider + object type)
• Target: Where data goes to (provider + object type)
• Direction: One-way or bidirectional
• Field Pairs: Which fields map to each other

Mapping Directions

Field Pairs

Field Pairs are the individual field mappings within a Mapping:

interface FieldPair {
  sourceField: string;      // e.g., "firstname"
  targetField: string;      // e.g., "first_name"
  transform?: string;       // e.g., "uppercase", "phone_e164"
  required: boolean;
}

Transforms

Transforms modify data as it moves between systems:

• uppercase / lowercase – Change text case
• phone_e164 – Format phone numbers to E.164 standard
• date_iso – Convert dates to ISO 8601 format
• split_name – Split "John Doe" into first/last name
• concatenate – Combine multiple fields

Syncs

A Sync is a single execution of a Mapping. It:

1. Fetches records from the source system
2. Applies transforms to each field
3. Creates or updates records in the target system
4. Logs results (success/failure counts)

Sync Statuses

Webhooks

Webhooks enable real-time syncing when data changes:

1. External system sends a webhook to FluxCascade
2. FluxCascade identifies affected mappings
3. Sync is triggered for the changed record(s)

This is more efficient than polling and ensures near-instant data synchronization.

Organizations

Organizations allow team collaboration:

• Invite team members to your organization
• Share connections and mappings
• Role-based access control (Owner, Admin, Member)
• Separate billing per organization