Skip to main content
GET
/
subscription-groups
List Subscription Groups
curl --request GET \
  --url https://api.brew.new/v1/subscription-groups \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "sg_newsletter",
    "name": "Weekly Newsletter",
    "description": "Our weekly digest of product updates and industry insights"
  },
  {
    "id": "sg_product_updates",
    "name": "Product Updates",
    "description": "Get notified about new features and improvements"
  },
  {
    "id": "sg_customers",
    "name": "Customer Communications",
    "description": null
  },
  {
    "id": "sg_promotions",
    "name": "Special Offers",
    "description": "Exclusive deals and promotional content"
  },
  {
    "id": "sg_beta_features",
    "name": "Beta Program",
    "description": null
  }
]

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

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"