API reference

Groups

/groups

A group is who a group-scoped event is about. A static group keeps a list you add to; a dynamic group holds whoever's attributes contain its filter, so nobody keeps it up. Beside the groups somebody keeps are temporary lists, picked by a person for one send: you can see them, but a key cannot change one and an event cannot name one. In the Political party pack a group is, for example, “Montserrado County”.

GET/groupsList · ?q ?external_ref ?temporary POST/groupsCreate GET/groups/{group_id}Read PATCH/groups/{group_id}Update · attributes replaced whole POST/groups/{group_id}/membersAdd members · up to 500 GET/groups/{group_id}/membersMembers · staticshown →DELETE/groups/{group_id}/members/{member_id}Remove a member POST/groups/syncBuild from an attribute GET/groups/{group_id}/matchesMatches · dynamic POST/groups/{group_id}/deactivateDeactivate · no delete

GETList who is in a group

Requires groups:read. The memberships a static group lists — or people, for a group of people — whole. A dynamic group keeps no list, and an empty one here would read as “nobody is in it”, so it is refused: ask /matches.

Path parameters

group_iduuid · required

The group id.

Query parameters

limitinteger · default 50 · max 200

offsetinteger · default 0

qstring · optional · max 100

Matches a member's name or number.

Returns

200 with an array of memberships or people. 400 on a dynamic group.

Response body

A bare JSON array. Each item is one membership: the same fields in every pack. Press Response on the sample to see one whole.

FieldTypeDescription

iduuid

tenant_iduuidThe instance.

external_refstring | nullYour own id, as you sent it.

display_namestring

attributesobjectShaped by the Political party pack's subject_schema.Varies by pack

statusactive | inactive

created_atdatetime

updated_atdatetime

On failure the body is { error, code } instead.

Previous← Authentication, keys and scopes NextEvent types →