actionxm data-sources

Manage data sources for importing events and profiles.

actionxm data-sources list

List all data sources for the current tenant.

actionxm data-sources list

Example:

$ actionxm data-sources list
Name                  Type        Project         Enabled  Events  Last Event       ID
Training Import       csv_upload  Acme Store      yes      1200    Feb 28, 2026     a1b2c3d4-...
CRM Integration       api_key     Acme Store      yes      58300   Mar 1, 2026      e5f6a7b8-...
Legacy Webhook        api_key     Acme Insights   no       0       -                c9d0e1f2-...

---

actionxm data-sources create

Create a new data source.

actionxm data-sources create --name <name> --type <type> --project-id <id> [options]

Required flags:

Flag	Description
--name <name>	Data source name
--type <type>	Source type: api_key or csv_upload
--project-id <id>	Project to attach the data source to

Optional flags:

Flag	Description
--identity-primary <field>	Primary identity field for profile matching
--identity-fallback <field>	Fallback identity field
--event-category <category>	Default event category for imported events

Example:

$ actionxm data-sources create \
    --name "Training Participants" \
    --type csv_upload \
    --project-id 550e8400-e29b-41d4-a716-446655440000
✓ Data source created: Training Participants
  ID:   a1b2c3d4-...
  Type: csv_upload

For api_key type sources, an API key is displayed on creation:

$ actionxm data-sources create \
    --name "CRM Integration" \
    --type api_key \
    --project-id 550e8400-e29b-41d4-a716-446655440000
✓ Data source created: CRM Integration
  ID:   e5f6a7b8-...
  Type: api_key

  API Key: axm_ds_k1a2b3c4d5e6f7...
  Save this key — it won't be shown again.

---

actionxm data-sources view <id>

View detailed information about a data source.

actionxm data-sources view <id>

Example:

$ actionxm data-sources view a1b2c3d4-...
Name:             Training Participants
Type:             csv_upload
Project ID:       550e8400-e29b-41d4-a716-446655440000
Enabled:          yes
Event Count:      1200
Last Event:       Feb 28, 2026
Identity Mapping: {"primary":"email"}
Event Mapping:    {"default_category":"survey"}
Created:          Feb 25, 2026
ID:               a1b2c3d4-...

---

actionxm data-sources remove <id>

Soft-delete a data source.

actionxm data-sources remove <id> [--confirm]

Flag	Description
--confirm	Skip confirmation prompt (for non-interactive use)

Example:

$ actionxm data-sources remove a1b2c3d4-...
Are you sure you want to remove data source a1b2c3d4-...? (y/N): y
✓ Data source a1b2c3d4-... removed.

---

actionxm data-sources upload <source-id> <file>

Upload an event CSV file to a data source.

actionxm data-sources upload <source-id> <file>

Argument	Description
<source-id>	Data source ID
<file>	Path to the CSV file

Example:

$ actionxm data-sources upload a1b2c3d4-... events.csv
✓ Upload complete.
  Total:     500
  Published: 498
  Errors:    2

Sample errors:
  Row 42: Missing required field "event_name"
  Row 315: Invalid timestamp format

---

actionxm data-sources import-profiles <file>

Import profiles from a CSV file.

actionxm data-sources import-profiles <file> [options]

Argument	Description
<file>	Path to the CSV file

Optional flags:

Flag	Description
--email-col <col>	Column name for email (default: email)
--phone-col <col>	Column name for phone number
--external-id-col <col>	Column name for external ID
--conflict <strategy>	Conflict resolution: merge, overwrite, skip (default: overwrite)
--source-id <id>	Data source ID to track import source

Example:

$ actionxm data-sources import-profiles participants.csv \
    --source-id a1b2c3d4-...
✓ Import complete.
  Total:     50
  Published: 50
  Errors:    0

With column mapping overrides:

$ actionxm data-sources import-profiles contacts.csv \
    --email-col user_email \
    --external-id-col crm_id \
    --conflict merge
✓ Import complete.
  Total:     200
  Published: 185
  Errors:    15

Sample errors:
  Row 12: Invalid email format
  Row 88: Invalid email format

---

Exit Codes

Code	Meaning
0	Success
1	Error (authentication, validation, API failure)