List Subscription Groups

Retrieve all subscription groups in your Brew account. Subscription groups allow you to organize your audience and give contacts control over what types of emails they receive. Use the group IDs when creating or updating contacts.

GET /subscription-groups

Try it

List Subscription Groups

cURL

curl --request GET \
  --url https://api.brew.new/v1/subscription-groups \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "sg_newsletter",
    "name": "Weekly Newsletter",
    "description": "Our weekly digest of product updates and industry insights"
  }
]

Authorizations

Authorization · string · header · required

Include your Brew API key as a Bearer token in the Authorization header. Example: Authorization: Bearer bw_api_your_key_here

Response

200

application/json

Subscription groups retrieved successfully

id · string · required

Unique subscription group identifier

Example:

"sg_newsletter"

name · string · required

Human-readable subscription group name

Example:

"Weekly Newsletter"

description · string | null · required

Description of what this subscription group covers (null if no description provided)

Example:

"Our weekly digest of product updates and industry insights"