Skip to content
Ads API •References / audiences / Create an Audience

Create an Audience

Creates a new audience.

Request

  • ad_account_idstring [uuid]
    Required

    A unique identifier for an Ad Account.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
Will be one of the following:
    • audience_typestring
      Required

      Type of the audience to create.

      Example: "CUSTOM"
    • namestring
      Required

      Name of the audience.

      Length between 2 and 80Example: "US - 18-24 - All gender"
    • descriptionstring

      Description of the audience.

      Maximum length: 80Example: "For spring promotion campaign"
    • audience_idstring [uuid]

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • subtypestring

      Subtype of the custom audience.

      Allowed values: "CUSTOMER_LIST", "WEB_EVENT", "AD_ENGAGEMENT", "LIVERAMP"
    • dataset_idsarray of strings

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • included_eventsarray of strings

      Event names to include in the audience.

      Example: "ADDTOCART"
    • excluded_eventsarray of strings

      Event names to exclude from the audience.

      Example: "PURCHASE"
    • lookback_daysinteger

      Lookback window for events.

      Range: 30 - 30
    • campaign_idsarray of strings

      Campaign IDs for ad engagement audiences.

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • ad_set_idsarray of strings

      Ad set IDs for ad engagement audiences.

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • exposure_typestring

      Type of ad exposure for ad engagement audiences.

      Allowed values: "IMPRESSIONS", "CLICKS"
    • audience_typestring
      Required

      Type of the audience to create.

      Example: "CUSTOM"
    • namestring
      Required

      Name of the audience.

      Length between 2 and 80Example: "US - 18-24 - All gender"
    • descriptionstring

      Description of the audience.

      Maximum length: 80Example: "For spring promotion campaign"
    • seed_audience_idstring [uuid]
      Required

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"

Response

An audience.

  • created_atstring [date-time]

    Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • updated_atstring [date-time]

    Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • idstring [uuid]

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • namestring

    Name of the audience.

    Length between 2 and 80Example: "US - 18-24 - All gender"
  • descriptionstring

    Description of the audience.

    Maximum length: 80Example: "For spring promotion campaign"
  • typestring

    Type of the audience.

    Default: "CUSTOM"Allowed values: "CUSTOM", "LOOKALIKE"
  • subtypestring

    Subtype of the custom audience.

    Allowed values: "CUSTOMER_LIST", "WEB_EVENT", "AD_ENGAGEMENT", "LIVERAMP"

  • An approximate range of users in the audience.

    • mininteger

      Minimum of an approximate range of users in the audience.

      Minimum value: 0
    • maxinteger

      Maximum of an approximate range of users in the audience.

      Minimum value: 0
  • statusstring

    Status of the audience.

    Default: "PROCESSING"Allowed values: "ARCHIVED", "PROCESSING", "EMPTY", "LEARNING", "BOOKABLE", "LIVE"
  • sourcesarray of strings

    Sources of the audience data.

    Source of the audience data.

    Default: "UNKNOWN"Allowed values: "UNKNOWN", "CUSTOMER_LIST", "AUDIENCE", "PIXEL", "CONVERSIONS_API", "AD_ENGAGEMENT", "LIVERAMP"
  • seed_audience_idstring [uuid]

    ID of the seed audience for the lookalike audience.

    Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • seed_audience_namestring

    Name of the audience.

    Length between 2 and 80Example: "US - 18-24 - All gender"
  • lookalike_audience_idsarray of strings

    IDs of the lookalike audiences created from the current audience.

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"

  • Datasets associated with the web event custom audience.

    • idstring [uuid]

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • namestring

      The name of the dataset.

  • included_eventsarray of strings

    Event names included in the web event custom audience.

    Example: "ADDTOCART"
  • excluded_eventsarray of strings

    Event names excluded from the web event custom audience.

    Example: "PURCHASE"
  • lookback_daysinteger

    Lookback window for events in the web event custom audience.

    Example: 30
  • campaign_idsarray of strings

    Campaign IDs for ad engagement audiences.

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • ad_set_idsarray of strings

    Ad set IDs for ad engagement audiences.

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • exposure_typestring

    Type of ad exposure for ad engagement audiences.

    Allowed values: "IMPRESSIONS", "CLICKS"

Response sample