RASL | Groups

Groups are used to categorize contacts based on business rules such as customer type, campaign enrollment, subscription status, or any custom segmentation strategy.

This module enables efficient contact grouping and bulk management operations.

Overview

Groups act as segmentation containers that can include multiple contacts.
A single contact may belong to multiple groups.

Common use cases include:

VIP Customers

Newsletter Subscribers

Active Clients

Leads from Campaign X

Region-based segmentation

Promotional audience lists

Groups improve targeting precision and simplify bulk operations across messaging workflows.

Available Endpoints

GET /groups

List Groups
Retrieve a paginated list of all groups.

POST /groups

Create Group
Create a new group.

GET /groups/{id}

Get Group
Retrieve detailed information for a specific group.

PATCH /groups/{id}

Update Group
Update group properties such as name or description.

DELETE /groups/{id}

Delete Group
Permanently delete a group.
This action removes the group association but does not delete contacts.

POST /groups/{id}/contacts

Add Contacts to Group
Add one or more contacts to a specific group.

DELETE /groups/{id}/contacts

Remove Contacts from Group
Remove one or more contacts from a group.

Common Behavior

Contacts can belong to multiple groups.

Deleting a group does not delete associated contacts.

Group membership updates are processed efficiently to support bulk operations.

Groups can be used in messaging filters and campaign targeting (if applicable).

Required Scopes

Depending on the operation, your API token must include:

groups:read

groups:write

groups:delete

Requests without the appropriate scope will return 403 INSUFFICIENT_SCOPE

Use Cases

Audience segmentation

Campaign targeting

CRM organization

Automation workflows

eCommerce customer categorization

Regional or behavioral grouping

The Groups module enhances data organization within RASL and enables scalable, structured communication strategies.

The Groups API allows you to organize contacts into logical segments for targeting, automation, and structured communication

Overview#

Available Endpoints#

GET /groups#

POST /groups#

GET /groups/{id}#

PATCH /groups/{id}#

DELETE /groups/{id}#

POST /groups/{id}/contacts#

DELETE /groups/{id}/contacts#

Common Behavior#

Required Scopes#

Use Cases#