---
title: "Add a subscriber"
method: POST
path: "/audience"
tags: ["Audience"]
---

# Add a subscriber

`POST /audience`

## Request

- Base URL: `https://doomscrollr.com/api/v1`
- URL: `https://doomscrollr.com/api/v1/audience`
- Auth: HTTP bearer

## Request body

- object: Provide either email or email_md5.
  - `email` string, email: Subscriber email address. Optional when email_md5 is provided.
  - `email_md5` string: MD5 hash of lowercase trimmed email when raw email is unavailable.
  - `first_name` string
  - `last_name` string
  - `phone` string
  - `gender` string
  - `source` string
  - `city` string
  - `state` string
  - `country` string
  - `bio` string
  - `username` string
  - `followers` integer
  - `tags` union
    - string[]
    - string
  - `utm_source` string
  - `utm_medium` string
  - `utm_campaign` string
  - `utm_content` string
  - `utm_term` string

## Response `201`

Created

## Other responses

- `429`: Monthly API rate limit exceeded

---

[API](https://skmtc.dev/doomscrollr/apis/doomscrollr-api.md) · [All operations](https://skmtc.dev/doomscrollr/apis/doomscrollr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/doomscrollr/apis/doomscrollr-api/revisions/0bd7ab034196?raw)