MMetadata /docs
Docs/Tools/create_linkedin_native_criteria_audience

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

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

Other audiences tools:

All 160 tools · machine-readable index