Audiences

Add members

Adds one or more members to the specified audience.

post/v1/audiences/{key}/members

Path parameters

keystring required

The key of the audience.

Query parameters

create_audienceboolean

Create the audience if it does not exist.

Request body

Example request

{
  "members": [
    {
      "tenant": "ingen_isla_nublar",
      "user": {
        "email": "ellie@ingen.net",
        "id": "dr_sattler",
        "name": "Dr. Ellie Sattler"
      }
    }
  ]
}

Response

No Content

Changes

Changed in 3 of the 30 revisions of this API.3124

Apr 14, 20263e8f3a4664d423See the full diff
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/chat/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/email/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/http/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/in_app_feed/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/push/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/sms/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channels/anyOf[subschema #1: PreferenceSetChannels]/additionalProperties/oneOf[subschema #2: PreferenceSetChannelSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/categories/anyOf[subschema #1: PreferenceSetRequestCategories]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/chat/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/email/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/http/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/in_app_feed/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/push/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/sms/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/channels/anyOf[subschema #1: PreferenceSetChannels]/additionalProperties/oneOf[subschema #2: PreferenceSetChannelSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/chat/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/email/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/http/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/in_app_feed/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/push/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channel_types/anyOf[subschema #1: PreferenceSetChannelTypes]/sms/oneOf[subschema #2: PreferenceSetChannelTypeSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/channels/anyOf[subschema #1: PreferenceSetChannels]/additionalProperties/oneOf[subschema #2: PreferenceSetChannelSetting]/conditions/items/operator
  request-property-enum-value-added
- ○
  added the new is_between enum value to the request property members/items/user/allOf[subschema #1: InlineIdentifyUserRequest]/preferences/allOf[subschema #1: InlinePreferenceSetRequest]/additionalProperties/workflows/anyOf[subschema #1: PreferenceSetRequestWorkflows]/additionalProperties/oneOf[subschema #2: PreferenceSetWorkflowCategorySettingObject]/conditions/items/operator
  request-property-enum-value-added
Feb 23, 2026b0b2bad50557211See the full diff
- ▲
  added InlineIdentifyUserRequest to the members/items/user request property allOf list
  request-property-all-of-added
- ▲
  the members/items/user request property type/format changed from object/ to /
  request-property-type-changed
- ●
  removed the request property members/items/user/id
  request-property-removed
- ○
  added the new optional query request parameter create_audience
  new-optional-request-parameter
Sep 23, 20259971ba6348f31See the full diff
- ▲
  removed the media type application/json for the response with the status 204
  response-media-type-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history