Twilio Cohorts

(new)

Beta

Twilio Cohorts is currently available as a Private Beta product and the information contained in this document is subject to change. You acknowledge and agree that your use of Twilio Cohorts is subject to the terms of the Services in Private Beta. This means that some features are not yet implemented and others may be changed before the product is declared as Generally Available. Private Beta products are not covered by the Twilio Support Terms or Twilio Service Level Agreement.

(new)

Beta

Request access to the private beta through this form.

(warning)

Not a HIPAA Eligible Service or PCI Compliant

Twilio Cohorts is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.

You can define reusable audience segments for your customer profiles and then generate point-in-time snapshots of the profiles that match those segments. Use Cohorts to create lists for messaging, operational workflows, system notifications, or data exports, so you do not need to maintain your own segmentation logic.

Get started now

Take the next steps with Twilio Cohorts

Start building cohorts

Learn more

Twilio servers

Your app

curl -X POST 'https://audiences.twilio.com/preview/Cohorts' \
-H 'Content-Type: application/json' \
-d '{
    "displayName": "Active US customers",
    "description": "US-based customers with an active account",
    "storeType": "TWILIO",
    "storeId": "mem_store_01h9d8r0vte3hz8tykdj329t7r",
    "criteria": "profile.trait.Account.status == \"active\" && profile.trait.Account.country == \"US\"",
    "labels": {
        "key": "value"
    }
}' \
-u $TWILIO_API_KEY:$TWILIO_API_SECRET

Define your first cohort in minutes.

Take the next steps with Twilio Cohorts

Start building cohorts

Learn more

Start building cohorts

Define your first cohort, generate a snapshot, and page through the matching profiles.

1HTTP/1.1 201 Created
2
3{
4    "id": "cmp_cohort_01h9d8r0vte3hz8tykdj329t7r",
5    "displayName": "Active US customers",
6    "description": "US-based customers with an active account",
7    "storeType": "TWILIO",
8    "storeId": "mem_store_01h9d8r0vte3hz8tykdj329t7r",
9    "criteria": "profile.trait.Account.status == \"active\" && profile.trait.Account.country == \"US\"",
10    "labels": {
11        "key": "value"
12    },
13    "createdAt": "2026-01-15T10:00:00Z",
14    "updatedAt": "2026-01-15T10:00:00Z"
15}