> ## Documentation Index
> Fetch the complete documentation index at: https://plai-a079b342.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Contact List Audience

> This endpoint allows you to create a custom audience by uploading a CSV file. The uploaded data is processed and matched against platform records to build a targeted audience for advertising purposes.

## Request Body

<Note>
  This endpoint requires the request body to be submitted as
  `multipart/form-data`. Ensure all required fields are included and properly
  formatted.
</Note>

<ParamField body="userId" type="string" required>
  User ID, If not already created, make a user on [create user
  page](/api-reference/endpoint/auth/create_user) first. If already created,
  retrieve the user ID from [get profile
  page](/api-reference/endpoint/auth/get_profile).
</ParamField>

<ParamField body="audienceName" type="string">
  The name of the audience you are creating. This name will be displayed in
  your LinkedIn Ads account.
</ParamField>

<ParamField body="mode" type="string" default="create">
  Mode: `create`
</ParamField>

<ParamField body="csv" type="file" required>
  <Card title="Download Sample Contact CSV" horizontal icon="download" href="https://content.linkedin.com/content/dam/help/en-us/lms/LinkedIn_Ads_Contact_Match_Template.csv" />

  <Card title="Download Sample Company CSV" horizontal icon="download" href="https://business.linkedin.com/content/dam/me/business/en-us/marketing-solutions/a/targeting/LinkedIn_Ads_Account_Match_Template.csv" />

  Upload the audience data file in `.csv` format. This file will be used to match users on LinkedIn.
</ParamField>

<ParamField body="type" type="string" required>
  Specifies the type of audience upload. Accepted values:
  `COMPANY_LIST_UPLOAD`: For uploading a list of company names. or
  `USER_LIST_UPLOAD`: For uploading a list of user identifiers (e.g., emails).
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates that the HTTP response was successful (status code 200 OK).
</ResponseField>

<ResponseField name="results" type="object">
  <Expandable title="Audience Results">
    <ResponseField name="success" type="boolean">
      Indicates whether the specific operation or API action was successful.
    </ResponseField>

    <ResponseField name="audience" type="object">
      <Expandable title="Audience Results">
        <ResponseField name="csvFileId" type="string">
          Csv File Id, this id will use in link\_csv\_audience endpoint to link csv. click [here](/api-reference/endpoint/linkedin/link_csv_audience) to learn more about the endpoint.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="error" type="string">
      Error string if something went wrong
    </ResponseField>
  </Expandable>
</ResponseField>