create_g2_intent_dynamic_audience
Create a **G2 Intent (Dynamic)** audience (platform `customAudienceType=DYNAMIC_G2_CONTACT`).
Writes audiences
Creates or changes something in the account. Put it behind whatever review your agent uses.
What it does
Create a **G2 Intent (Dynamic)** audience (platform `customAudienceType=DYNAMIC_G2_CONTACT`).
AUDIENCE TYPE (mirrors the UI's "Audience Type" dropdown):
• UI label: "G2 Intent (Dynamic)"
• Platform enum: DYNAMIC_G2_CONTACT
• Refreshes daily as G2 intent signals update; uses generic contact criteria (not LinkedIn-native).
PREREQUISITE:
• G2 integration MUST be connected. If not, do NOT call this tool — recommend `create_firmographic_audience`.
WHEN TO USE (exact user phrasing this tool should match):
• "G2 Intent (Dynamic)" (without "LinkedIn Native")
• "G2 intent dynamic audience"
• "Dynamic G2 audience"
• The user wants G2 intent that refreshes daily on Facebook/LinkedIn/other channels (not specifically LinkedIn-native).
WHEN NOT TO USE:
• If the user said "LinkedIn Native" → use `create_g2_intent_linkedin_native_dynamic_audience`.
• If the user said "Static" → use `create_g2_intent_static_audience`.
BUYING STAGES — REQUIRED BY THE PLATFORM:
Same as the LinkedIn Native variant: ASK the user if missing. DO NOT default.
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
- location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
- location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
- job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
- job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS:
Valid job function IDs and their labels:
- 1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
- 7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
- 13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
- 18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
- 22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
- 25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
- job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
- job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS:
Valid seniority IDs and their labels:
- 2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
- 8: Senior, 9: Owner, 10: Entry, 11: Partner
- seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
- seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
- contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
- All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
- Job titles are free text strings, not IDs
- Use include parameters to specify which criteria to target
- Use exclude parameters to filter out contacts matching specific criteria
- Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
- Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
- location_country_ids: Array of country IDs (optional)
- location_state_ids: Array of state IDs (optional)
- job_title_includes: Array of job title keywords to include (optional)
- job_title_excludes: Array of job title keywords to exclude (optional)
- job_function_include_ids: Array of job function IDs (optional)
- job_function_exclude_ids: Array of job function IDs (optional)
- seniority_include_ids: Array of seniority level IDs (optional)
- seniority_exclude_ids: Array of seniority level IDs (optional)
- contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS:
• name (required, ≤ 50 chars)
• intent_days (required, 1-365)
• buying_stages (REQUIRED by platform — ask if missing)
• Contact criteria as in CONTACTS CRITERIA above.
RETURNS: id, audience_id, audience_name, audience_type (DYNAMIC_G2_CONTACT), status, buying_stages, intent_days, counts.Arguments
| Argument | Type | Notes | |
|---|---|---|---|
name |
string | required | Audience name (required, max 50 characters). |
intent_days |
integer | required | Days to look back for G2 intent signals (required, 1-365). |
buying_stages |
array | Buying stages to target. The platform REQUIRES at least one; if the user did not specify, ASK them before calling — do NOT default. | |
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 | |
location_state_ids |
array | State IDs for geographic targeting (optional). Valid US State IDs: 1 (Alabama), 2 (Alaska), 3 (Arizona), 4 (Arkansas), 5 (California), 6 (Colorado), 7 (Connecticut), 8 (Delaware), 9 (Florida), 10 (Georgia), 11 (Hawaii), 12 (Idaho), 13 (Illinois), 14 (Indiana), 15 (Iowa), 16 (Kansas), 17 (Kentucky), | |
job_title_includes |
array | Free text keywords for job titles to include (optional). Example: ['Software Engineer', 'Manager'] | |
job_title_excludes |
array | Free text keywords for job titles to exclude (optional). Example: ['Senior', 'Lead'] | |
job_function_include_ids |
array | Job function IDs to include (optional). Valid IDs: 1 (Marketing), 2 (Sales), 3 (Customer Service), 4 (Finance), 5 (HR), 6 (PR), 7 (Media), 8 (Design), 9 (Engineering), 10 (Operations), 11 (Legal), 12 (Education), 13 (Health), 14 (Real Estate), 15 (Accounting), 16 (Administrative), 17 (Business Devel | |
job_function_exclude_ids |
array | Job function IDs to exclude (optional). Valid IDs: 1-28 as listed above | |
seniority_include_ids |
array | Seniority level IDs to include (optional). Valid IDs: 2 (Manager), 3 (Director), 4 (VP), 5 (CXO), 6 (Unpaid), 7 (Training), 8 (Senior), 9 (Owner), 10 (Entry), 11 (Partner). Example: [10, 7] for Entry and Training | |
seniority_exclude_ids |
array | Seniority level IDs to exclude (optional). Valid IDs: 2-11 as listed above | |
contacts_per_company_limit |
integer | Maximum number of contacts to target per company (optional). Example: 20 |
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_g2_intent_dynamic_audience","arguments":{"name":"<name>","intent_days":0}}}'
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: