RASL | Contacts

Contacts serve as the foundation for messaging, segmentation, automation, and reporting.

This module supports full CRUD operations as well as bulk processing for high-volume data management.

Overview

Contacts represent individual WhatsApp recipients and can store:

Phone number (required and normalized)

First and last name

Company

Country

Custom attributes (if enabled)

Associated groups

Status

Source

Contacts are tightly integrated with the Messaging and Authentication modules.

Available Endpoints

GET /contacts

List Contacts
Retrieve a paginated, filterable, and searchable list of contacts.

POST /contacts

Create Contact
Create a new contact manually.

GET /contacts/{id}

Get Contact
Retrieve detailed information for a specific contact.

PATCH /contacts/{id}

Update Contact
Update selected fields of an existing contact.

DELETE /contacts/{id}

Delete Contact
Permanently remove a contact from your tenant.

POST /contacts/batch

Batch Create Contacts
Create multiple contacts in a single request (useful for imports and migrations).

DELETE /contacts/batch

Batch Delete Contacts
Delete multiple contacts using a list of contact IDs.

Common Behavior

Phone numbers are validated and normalized before storage.

Contacts may be auto-created when sending messages (if enabled).

Deleting a contact does not automatically remove historical message records unless explicitly configured.

Batch operations are processed efficiently to support large datasets.

Required Scopes

Depending on the action, your API token must include:

contacts:read

contacts:write

contacts:delete

Requests without the appropriate scope will return 403 INSUFFICIENT_SCOPE

Use Cases

CRM synchronization

Lead capture automation

Bulk contact imports

Data cleanup operations

Integration with ERP, eCommerce, and marketing platforms

The Contacts module forms the core data layer of RASL, enabling structured customer management across messaging and automation workflows.

The Contacts API allows you to manage customer and lead records within your RASL tenant

Overview#

Available Endpoints#

GET /contacts#

POST /contacts#

GET /contacts/{id}#

PATCH /contacts/{id}#

DELETE /contacts/{id}#

POST /contacts/batch#

DELETE /contacts/batch#

Common Behavior#

Required Scopes#

Use Cases#