Skip to content
Dashboard

Add changelog subscribers

POST/v2/changelogs/subscribers

Adds email addresses as changelog subscribers in bulk.

Subscribers will receive email notifications when new changelogs are published (if email notifications are enabled during publishing).

Request Body

  • emails - Array of email addresses to add (required, 1-1000 emails)
  • locale - Locale for the subscribers (optional, defaults to organization default)

Email Validation

  • Invalid email addresses are automatically filtered out
  • Emails are normalized (trimmed, lowercased)
  • Duplicate emails are deduplicated

Rate Limiting

This endpoint is rate limited to prevent abuse. If you need to import more subscribers, please contact support.

Response

Returns a confirmation with the count of processed emails:

{
  "object": "changelog_subscribers_import",
  "count": 150
}

Errors

  • 400 - Invalid request (empty emails array, too many emails)
  • 429 - Rate limit exceeded
Header ParametersExpand Collapse
"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"
One of the following:
"2026-01-01.nova"
"2025-12-12.clover"
Body ParametersJSONExpand Collapse
emails: array of string

Array of email addresses to add as changelog subscribers

locale: optional "bn" or "bs" or "pt-BR" or 39 more

The locale for the subscribers. Defaults to organization default locale.

One of the following:
"bn"
"bs"
"pt-BR"
"bg"
"ca"
"hr"
"cs"
"da"
"nl"
"en"
"et"
"fi"
"fr"
"de"
"el"
"hi"
"hu"
"id"
"it"
"ja"
"ko"
"lv"
"lt"
"ms"
"mn"
"nb"
"pl"
"pt"
"ro"
"ru"
"sr"
"zh-CN"
"sk"
"sl"
"es"
"sw"
"sv"
"th"
"zh-TW"
"tr"
"uk"
"vi"
ReturnsExpand Collapse
count: number

Number of email addresses processed

object: "changelog_subscribers_import"

Object type identifier

Add changelog subscribers

curl https://do.featurebase.app/v2/changelogs/subscribers \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY" \
    -d '{
          "emails": [
            "john@example.com",
            "jane@example.com"
          ],
          "locale": "en"
        }'
{
  "count": 150,
  "object": "changelog_subscribers_import"
}
Returns Examples
{
  "count": 150,
  "object": "changelog_subscribers_import"
}