Skip to main content
POST
curl

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Body

application/json
filter
object
required

The rule that decides who is in a group. A contact is in the group when it matches conditions (joined by operator), matches every condition in requiredConditions, and matches none of excludeConditions. Each list holds at most 20 conditions, and at least one condition is needed across the three lists (otherwise 422 EMPTY_FILTER). Unsubscribed contacts are never members. See Group conditions.

Response

How many contacts the rule matches.

memberCount
integer
required

How many contacts the rule matches now (never unsubscribed contacts). A count only.

Required range: x >= 0