actionxm profiles

Manage Experience Graph (XG) profiles — view contacts and shadows, browse activity, manage traits, and inspect identity resolutions.

actionxm profiles list

List profiles for the current tenant.

actionxm profiles list [options]

Options:

Flag	Description
--type <type>	Filter by type: shadow, contact, or all (default: all)
--search <text>	Search by name, email, or shadow ID
--label <name>	Filter by label name
--page <n>	Page number (default: 1)
--page-size <n>	Results per page (default: 25)

Example:

$ actionxm profiles list --type contact --search alice
Name/Email                     Type     Labels              Sessions  Touchpoints  Last Seen        ID
Alice Johnson                  contact  customer, lead      12        87           Feb 28, 2026     a1b2c3d4-e5f6...
alice.test@example.com         contact  subscriber          3         15           Feb 25, 2026     f7a8b9c0-d1e2...

Page 1 of 1 (2 total)

---

actionxm profiles view <id>

View detailed information about a profile.

actionxm profiles view <id>

Example:

$ actionxm profiles view a1b2c3d4-e5f6-...
Name:         Alice Johnson
Email:        alice@acme.com
Phone:        +1-555-0100
External ID:  usr_12345
Type:         contact
Labels:       customer, lead
Sessions:     12
Touchpoints:  87
First Seen:   Jan 15, 2026 10:30 AM
Last Seen:    Feb 28, 2026 3:45 PM
Resolved To:  -
ID:           a1b2c3d4-e5f6-...

---

actionxm profiles activity <id>

View the activity timeline (touchpoints) for a profile.

actionxm profiles activity <id> [options]

Options:

Flag	Description
--event-category <cat>	Filter by event category
--page <n>	Page number (default: 1)

Example:

$ actionxm profiles activity a1b2c3d4-... --event-category pageview
Event       Category   URL                                      Timestamp            Device   Browser
pageview    pageview   /products/widget-pro                     Feb 28, 3:45 PM      desktop  Chrome
pageview    pageview   /pricing                                 Feb 28, 3:42 PM      desktop  Chrome
pageview    pageview   /                                        Feb 28, 3:40 PM      desktop  Chrome

Page 1 of 2 (42 total)

---

actionxm profiles traits

View or manage traits for a profile.

actionxm profiles traits list <id>

List all traits for a profile.

actionxm profiles traits list <id>

Example:

$ actionxm profiles traits list a1b2c3d4-...
Key                  Value                                              Type     Source    Updated
total_touchpoints    87                                                 number   system   Feb 28, 2026
total_pageviews      42                                                 number   system   Feb 28, 2026
primary_browser      Chrome                                             string   system   Feb 28, 2026
plan                 enterprise                                        string   api      Feb 27, 2026
company              Acme Corp                                          string   api      Feb 25, 2026

actionxm profiles traits set <id>

Set a trait on a profile.

actionxm profiles traits set <id> --key <key> --value <value> [--type <type>]

Required flags:

Flag	Description
--key <key>	Trait key
--value <value>	Trait value

Optional flags:

Flag	Description
--type <type>	Trait type: string, number, or boolean (default: string)

Example:

$ actionxm profiles traits set a1b2c3d4-... --key plan --value enterprise
✓ Trait set: plan = enterprise

actionxm profiles traits delete <id>

Delete a trait from a profile.

actionxm profiles traits delete <id> --key <key>

Flag	Description
--key <key>	Trait key to delete

Example:

$ actionxm profiles traits delete a1b2c3d4-... --key legacy_flag
✓ Trait legacy_flag deleted.

---

actionxm profiles sessions <id>

List sessions associated with a profile.

actionxm profiles sessions <id>

Example:

$ actionxm profiles sessions a1b2c3d4-...
Session ID                             Site ID
f1a2b3c4-d5e6-7890-abcd-ef1234567890  550e8400-e29b-41d4-a716-446655440000
a9b8c7d6-e5f4-3210-fedc-ba9876543210  550e8400-e29b-41d4-a716-446655440000

---

actionxm profiles identities <id>

List identity records for a profile.

actionxm profiles identities <id>

Example:

$ actionxm profiles identities a1b2c3d4-...
Type          Value                    Confidence  Source       Created
email         alice@acme.com           100         sdk          Jan 15, 2026
external_id   usr_12345                100         api          Jan 20, 2026
phone         +1-555-0100              80          csv_import   Feb 1, 2026

---

actionxm profiles resolutions <id>

View identity resolution history for a profile (shadow-to-contact merges).

actionxm profiles resolutions <id>

Example:

$ actionxm profiles resolutions a1b2c3d4-...
Shadow ID      Contact ID     Identity Type  Value                    Merged  Resolved At
b2c3d4e5-f... a1b2c3d4-e...  email          alice@acme.com           15      Feb 20, 3:15 PM
c3d4e5f6-a... a1b2c3d4-e...  external_id    usr_12345                8       Feb 22, 11:30 AM

---

actionxm profiles surveys <id>

View survey responses submitted by a profile.

actionxm profiles surveys <id>

Example:

$ actionxm profiles surveys a1b2c3d4-...
Survey Name                    Type    Submitted At
Q1 NPS Survey                  nps     Feb 25, 2:30 PM
Product Feedback               custom  Feb 20, 10:15 AM

---

actionxm profiles trait-history <id>

View the trait change audit log for a profile.

actionxm profiles trait-history <id>

Example:

$ actionxm profiles trait-history a1b2c3d4-...
Key                  Old Value                  New Value                  Source    Changed At
plan                 pro                        enterprise                api      Feb 27, 4:00 PM
total_touchpoints    85                         87                        system   Feb 28, 3:45 PM
primary_browser      (empty)                    Chrome                    system   Jan 15, 10:30 AM

---

Exit Codes

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