---
title: "Add members"
method: POST
path: "/v1/audiences/{key}/members"
tags: ["Audiences"]
---

# Add members

`POST /v1/audiences/{key}/members`

Adds one or more members to the specified audience.

## Path parameters

- `key` string, required

## Query parameters

- `create_audience` boolean

## Request body

- AddAudienceMembersRequest — A request to add a list of audience members.
  - `members` AudienceMemberRequest[], required — A list of audience members to add. You can add up to 1,000 members per request.
    - `tenant` string, nullable — The unique identifier for the tenant.
    - `user` InlineIdentifyUserRequest, required — A set of parameters to inline-identify a user with. Inline identifying the user will ensure that the user is available before the request is executed in Knock. It will perform an upsert for the user you're supplying, replacing any properties specified.
      - `avatar` string, nullable — A URL for the avatar of the user.
      - `channel_data` InlineChannelDataRequest — A request to set channel data for a type of channel inline.
      - `created_at` string, date-time, nullable — The creation date of the user from your system.
      - `email` string, nullable — The primary email address for the user.
      - `id` string, required — The unique identifier of the user.
      - `locale` string, nullable — The locale of the user. Used for [message localization](/concepts/translations).
      - `name` string, nullable — Display name of the user.
      - `phone_number` string, nullable — The [E.164](https://www.twilio.com/docs/glossary/what-e164) phone number of the user (required for SMS channels).
      - `preferences` InlinePreferenceSetRequest — Inline set preferences for a recipient, where the key is the preference set id. Preferences that are set inline will be merged into any existing preferences rather than replacing them.
      - `timezone` string, nullable — The timezone of the user. Must be a valid [tz database time zone string](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Used for [recurring schedules](/concepts/schedules#scheduling-workflows-with-recurring-schedules-for-recipients).

## Response `204`

No Content

---

[API](https://skmtc.net/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.net/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knocklabs/knock-api/revisions/4b8499dddbc5/schema)