create_bombora_audience

Create Bombora buyer intent audiences on the Metadata platform.
                Creates B2B audiences based on buyer intent topics, company firmographics, contact attributes, and geographic targeting.

                IMPORTANT PREREQUISITE:
                Before using this tool, call get_intent_topics first to verify that Bombora topics are available.
                If get_intent_topics returns NO topics (empty list), Bombora is NOT available for this account —
                do NOT suggest or use this tool. Instead, recommend creating a firmographic audience
                (create_firmographic_audience) as the preferred alternative.
                Firmographic audiences are the default and most commonly used audience type.

                WHEN TO USE:
                - ONLY after get_intent_topics confirms that Bombora topics are available
                - Create targeted B2B audiences based on buyer intent signals using Bombora data
                - Target companies by industry, size, and employee count
                - Target contacts by seniority level and job function
                - Target specific buyer intent topics (e.g., Pardot, Salesforce)
                - Set geographic targeting and contact limits per company

                BUYER INTENT TOPICS:
                Use the get_intent_topics tool to retrieve available intent topics before creating the audience.
                Intent topics represent buyer interest areas such as:
                - CRM solutions (e.g., Pardot, Salesforce)
                - Marketing automation platforms
                - Analytics and BI tools
                - And many others based on available topics

                TARGETING OPTIONS:
                - Intent Topics: Use topic values from get_intent_topics (required for Bombora audience)
                - Industries: Use industry IDs. Examples:
                  1=Defense & Space, 4=Computer Software, 6=Internet, 7=Semiconductors, 8=Telecommunications,
                  11=Management Consulting, 12=Biotechnology, 41=Banking, 42=Insurance, 43=Financial Services,
                  80=Marketing & Advertising, 96=Information Technology & Services
                - Employees: "FROM_1_TO_10", "FROM_10_TO_50", "FROM_50_TO_200", "FROM_200_TO_500", "FROM_500_TO_1000", "FROM_1000_TO_5000", "FROM_5000_TO_10000", "OVER_10000"
                - Job Function / Seniority / Job Title / Location: identical shape to the Firmographic + G2 tools (PRD-29704 — the old Bombora-specific names `function_ids` / `seniority_ids` / `countries` / `cities` were renamed to the canonical contact-criteria fields below so Max can transfer the same criteria across audience types).

                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)


                Returns audience details with ID, size estimation, and creation status.