## 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:

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

### Errors

- `400` - Invalid request (empty emails array, too many emails)
- `429` - Rate limit exceeded

### Header Parameters

- `"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"`

  - `"2026-01-01.nova"`

  - `"2025-12-12.clover"`

### Body Parameters

- `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.

  - `"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"`

### Returns

- `count: number`

  Number of email addresses processed

- `object: "changelog_subscribers_import"`

  Object type identifier

  - `"changelog_subscribers_import"`

### Example

```http
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"
        }'
```

#### Response

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