Replace audience companies
Changed onUpload the company rows of a LinkedIn company_list audience (account-based marketing). LinkedIn-only, every other platform returns 422.
A LinkedIn audience segment holds exactly one uploaded list, so the list you send here REPLACES the segment's list instead of being appended to it: always send the full set of companies. LinkedIn returns only the identifier of the uploaded file, never its rows, so the merge cannot be done for you, keep the source list on your side.
How the matching behaves:
- Rows are plain text (not hashed), matched against LinkedIn's own company graph.
- Matching is asynchronous: LinkedIn takes up to 48h for a new audience and up to 24h for a later update, and the audience stays processing meanwhile.
- LinkedIn does not document how quickly companies dropped from the list stop being targeted, so treat removals as eventual rather than immediate.
- LinkedIn recommends at least 1,000 companies for a usable match rate, and caps a list at 300,000.
The initial list is sent with companies on POST /v1/ads/audiences; this endpoint is for every change after that.
Request
- Base URL: https://zernio.com/api
- URL: https://zernio.com/api/v1/ads/audiences/{audienceId}/companies
- Auth: HTTP bearer
Path parameters
The Zernio audience id (the id field of GET /v1/ads/audiences), not the platform segment id.
Request body
Response
Companies uploaded
Changes
- warning
added the new
accountenum value to the/response property for the response status
- warning
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status
- info