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.

POST /linkedin/create_csv_audience

Create Contact List Audience

cURL

curl --request POST \
  --url https://public.plai.io/linkedin/create_csv_audience \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'userId=<string>' \
  --form 'audienceName=<string>' \
  --form 'mode=<string>' \
  --form 'type=<string>' \
  --form csv='@example-file'

200

{
  "success": true,
  "results": {
    "success": true,
    "audience": {
      "csvFileId": "<string>"
    },
    "error": "<string>"
  }
}

Request Body

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

userId · string · required

User ID, If not already created, make a user on create user page first. If already created, retrieve the user ID from get profile page.

audienceName · string

The name of the audience you are creating. This name will be displayed in your LinkedIn Ads account.

mode · string · default: "create"

Mode: create

csv · file · required

Download Sample Contact CSV

Download Sample Company CSV

Upload the audience data file in .csv format. This file will be used to match users on LinkedIn.

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).

Response

success · boolean

Indicates that the HTTP response was successful (status code 200 OK).

results · object

Show Audience Results

success · boolean

Indicates whether the specific operation or API action was successful.

audience · object

Show Audience Results

csvFileId · string

Csv File Id, this id will use in link_csv_audience endpoint to link csv. click here to learn more about the endpoint.

error · string

Error string if something went wrong