Skip to main content

Experience Groups

Experience Groups APIs allow financial institutions to organize and segment users into logical groups for targeted digital experiences. These groups are used to support personalized features, promotions, experiments, and A/B testing within the digital banking platform.

End-user benefits​

  • Creating and managing experience groups for user segmentation
  • Bulk upload user lists via CSV (ADD, REMOVE, REPLACE operations)
  • Control feature rollouts and A/B testing with defined cohorts
  • Enable personalized experiences for different customer segments

Integration capabilities​

  • Group Management: Create, update, list, and delete experience groups
  • Participant Management: Upload user lists (ADD, REMOVE, REPLACE operations)
  • Pagination: Navigate through large result sets efficiently

File Upload Requirements​

When uploading participants to Experience Groups, the CSV file must:

  • Contain participant IDs (max 32 characters each)
  • Specify the operation type: ADD, REMOVE, or REPLACE
  • Be uploaded as multipart/form-data

Scopes​

ScopeDescription
groups:readRead experience groups
groups:writeCreate, update, and delete experience groups

Required headers​

HeaderDescription
AuthorizationBearer {ACCESS_TOKEN}
transactionIdUUID (fish tag / tracing)

Error codes​

CodeMessageHTTP Status Code
1000Success (e.g. upload accepted, group deleted)200
2000Client / validation (e.g. invalid data, not found)400
2001Internal server error or generic bad request400 / 500
2003Invalid authorization401

Endpoints​

Create Experience Group

Creates a new experience group for organizing users. Experience groups allow you to segment users for

Delete Experience Group

Deletes an experience group and removes all user associations. This action cannot be undone.

List Experience Groups

Retrieves all experience groups with their participant counts. Use pagination parameters to navigate through

Update Experience Group

Updates an existing experience group. You can modify the group name and description.

Upload Group Participants File

Uploads a CSV file containing participant IDs to add, remove, or replace users in an experience group.