Contact Groups
Comprehensive API for managing contact groups and organizing contacts
Reading time: 2 minutes
Contact Groups
Comprehensive management of contact groups to efficiently organize contacts.
Contact Group Operations
Important Notes
š”
Status
status: 1= Active (can be used)status: 0= Inactive (hidden)- Status can be changed at any time
ā ļø
Deletion
- Deleting group does not delete contacts
- Contacts will remain but without a group
- It's recommended to move contacts to another group before deletion
ā
Best Practices
- Use clear and distinctive group names
- Organize groups by category (customers, suppliers, employees)
- Review groups regularly and clean up unused groups
Use Cases
Create Group and Classify Customers
// 1. Create group
const group = await createContactGroup({
name: "VIP Customers",
status: 1
});
// 2. Link contacts to group
const contact = await createContact({
name: "Ahmed Mohammed",
phone: "96650000000",
contact_group_id: group.data.id
});Filter Contacts by Group
GET /contacts?contact_group_id=1&phone_number_id=123456Error Codes
| Code | Description | Cause | Solution |
|---|---|---|---|
| 400 | Bad Request | Invalid data | Check sent data |
| 404 | Not Found | Group not found | Verify group ID |
| 409 | Conflict | Duplicate group name | Use a different name |
| 422 | Validation Error | Validation error | Review error message |
Related Sections
Technical Support
Need help?
- š§ Email: support@awalchat.com
- š¬ Live Chat: Available in dashboard
- š± WhatsApp: Contact us directly via WhatsApp
- š Examples: See Code Examples