create_linkedin_native_criteria_audience
Create a LinkedIn native criteria audience using LinkedIn-supported targeting criteria.
Writes audiences
Creates or changes something in the account. Put it behind whatever review your agent uses.
What it does
Create a LinkedIn native criteria audience using LinkedIn-supported targeting criteria.
Build audiences based on job titles, skills, company names, employee count ranges, revenue ranges, and geographic location.
ESTIMATE-ONLY MODE:
Pass estimate_only=true to preview audience size WITHOUT creating the audience. In this mode the tool
returns expectedNumberOfContacts. Default is false.
ALSO KNOWN AS: LinkedIn audience, LI criteria audience, native LinkedIn targeting, LinkedIn lead audience
KEYWORDS: LinkedIn, native, criteria, audience, job title, skills, company, company name, employees, revenue, targeting, country, location
WHEN TO USE:
- Create targeted LinkedIn audiences using native LinkedIn criteria
- Target users by job titles (e.g., Software Engineer, Product Manager)
- Target by professional skills (e.g., HubSpot, Salesforce, Python)
- Target by company names (e.g., Metadata, Google, Salesforce)
- Filter by company employee count ranges (e.g., 201-500, 1001-5000)
- Filter by company revenue ranges (e.g., $1M-$10M, $10M-$100M)
- Target by country/geographic location (e.g., United States, United Kingdom)
PARAMETERS:
- name: Audience name (required, must be shorter than 50 characters)
- job_titles: Array of free-text job title strings (optional) - e.g., ["Software Engineer", "Product Manager"]
- skills: Array of free-text skill strings (optional) - e.g., ["HubSpot", "Salesforce", "Python"]
- company_names: Array of free-text company name strings (optional) - e.g., ["Metadata", "Google", "Salesforce"]
- employees: Array of LinkedIn employee count ranges (optional) - valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, +10001
- revenues: Array of LinkedIn revenue ranges (optional) - valid values: Under $1M, $1M-$10M, $10M-$100M, $100M-$1B, $1B+
- location_country_ids: Array of country ID integers (optional) - e.g., [229] for United States
RETURNS:
Audience details with ID, status, and creation info.
IMPORTANT NOTES:
- name is the only required parameter, all other parameters are optional
- Audience name must be shorter than 50 characters
- Job titles, skills, company names, employees, and revenues are free-text arrays
- Country IDs are integer identifiers (e.g., 229 = United States)Arguments
| Argument | Type | Notes | |
|---|---|---|---|
name |
string | required | Audience name (required, must be shorter than 50 characters). |
job_titles |
array | Free-text job title strings for targeting. Example: ['Software Engineer', 'Product Manager'] | |
skills |
array | Free-text skill strings for targeting. Example: ['HubSpot', 'Salesforce', 'Python'] | |
company_names |
array | Free-text company name strings for targeting. Example: ['Metadata', 'Google', 'Salesforce'] | |
employees |
array | LinkedIn employee count ranges for audience targeting. Valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, +10001. Example: ['201-500', '501-1000'] | |
revenues |
array | LinkedIn revenue ranges for audience targeting. Valid values: Under $1M, $1M-$10M, $10M-$100M, $100M-$1B, $1B+. Example: ['$1M-$10M', '$10M-$100M'] | |
location_country_ids |
array | Country IDs for geographic targeting (optional). Valid IDs: 1 (Afghanistan), 2 (Albania), 3 (Algeria), 4 (American Samoa), 5 (Andorra), 6 (Angola), 7 (Anguilla), 8 (Antarctica), 9 (Antigua and Barbuda), 10 (Argentina), 11 (Armenia), 12 (Aruba), 13 (Australia), 14 (Austria), 15 (Azerbaijan), 16 (Baha | |
estimate_only |
boolean | If true, do NOT create the audience — only estimate its size and return the expected contact count. Use this when the user wants to preview LinkedIn audience size before committing. Defaults to false (audience is created). |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_linkedin_native_criteria_audience","arguments":{"name":"<name>"}}}'
Response
No recorded response. This tool writes to the account, so it is never executed to build these docs.
The request above is still the exact shape to send. Nothing on this page is invented.
Related
Other audiences tools: