tdx Connector Config

Configure connector_config for activations by discovering fields with tdx connection schema.

Key Commands

# List connections (shows type and name)
tdx connection list

# Discover connector_config fields (ALWAYS run this first)
tdx connection schema <connector_type>   # Pass the TYPE (not connection name)

# List all connector types
tdx connection types

Schema vs Settings: schema shows connector_config fields for activations. settings shows credentials for creating connections.

Workflow

tdx connection list                                    # 1. Find connection type
tdx connection schema salesforce_marketing_cloud_v2    # 2. Get schema fields
# 3. Write connector_config → 4. tdx sg push --dry-run

Common Connector Types

Salesforce Marketing Cloud (salesforcemarketingcloud_v2)

connector_config:
  de_name: CustomerSegment           # Data Extension name (requires primary key)
  shared_data_extension: false
  data_operation: upsert             # upsert | replace
  # For creating new DE:
  create_new_de: true
  folder_path: Segments/Marketing
  primary_column: email
  is_sendable: true
  sendable_rule: Email Address       # "Subscriber Key" | "Email Address"
  sendable_column: email

Salesforce CRM (sfdc_v2)

connector_config:
  object: Contact
  mode: update                       # append | truncate | update
  unique: email                      # Key field (when mode=update)
  upsert: true

AWS S3 (s3_v2)

connector_config:
  bucket: my-bucket
  path: exports/segments/data.csv
  format: csv                        # csv | tsv | jsonl
  compression: gz                    # none | gz

BigQuery (bigquery_v2)

connector_config:
  project: my-gcp-project
  dataset: marketing
  table: segments
  mode: APPEND                       # APPEND | REPLACE | REPLACE_BACKUP | TRUNCATE
  auto_create_table: true

Treasure Data (treasure_data)

connector_config:
  database_name: marketing_db
  table_name: exported_segments
  mode: append                       # append | replace

Conditional Fields

Schema output shows when fields apply:

unique: Key [text]
  Show when: mode=["update"]

Only include unique when mode is update.

Related Skills

• activation - Activation structure (connection, schedule, columns, notifications)
• segment - Segment rule syntax
• journey - Journey structure and activation steps