MMetadata /docs
Docs/Tools/create_g2_intent_dynamic_audience

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

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

Other audiences tools:

All 160 tools · machine-readable index