create_facebook_native_criteria_audience

Create a Facebook native criteria audience using Facebook-supported targeting criteria.
                Build audiences based on Facebook native industries, geographic location, job titles, interests, and age range.

                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: Facebook audience, FB criteria audience, native Facebook targeting, Facebook lead audience

                KEYWORDS: Facebook, native, criteria, audience, industry, location, job title, interest, age, lead, targeting

                WHEN TO USE:
                - Create targeted Facebook audiences using native Facebook criteria
                - Target users by Facebook industry categories (e.g., IT and Technical Services, Sales, Management)
                - Target by geographic countries, job titles, interests, and age range
                - Build lead generation audiences for Facebook campaigns

                INDUSTRIES:
                Facebook native industry categories - provide the industry name as a string:
                Administrative Services, Architecture and Engineering, Arts Entertainment Sports and Media,
                Business and Finance, Business decision maker titles and interests, Cleaning and Maintenance Services,
                Community and Social Services, Computation and Mathematics, Construction and Extraction,
                Education and Libraries, Farming Fishing and Forestry, Food and Restaurants,
                Government Employees (Global), Healthcare and Medical Services, Installation and Repair Services,
                IT and Technical Services, Large business-to-business enterprise employees (500+ employees),
                Legal Services, Life Physical and Social Sciences, Management,
                Medium business-to-business enterprise employees (200 - 500 employees), Production, Sales,
                Small business-to-business enterprise employees (10-200 employees), Transportation and Moving

                PARAMETERS:
                - name: Audience name (required)
                - min_age: Minimum age for targeting (required) - must be between 21 and 65
                - max_age: Maximum age for targeting (required) - must be between 21 and 65, and >= min_age
                - industries: Array of Facebook native industry names (optional)
                - countries: List of country names for location targeting (optional) - each must match a country from the platform's supported countries list
                - job_titles: Array of free-text job title strings (optional) - e.g., ["Software Engineer", "Product Owner"]
                - interests: Array of free-text interest strings (optional) - e.g., ["Java", "Python", "Cloud Computing"]

                RETURNS:
                Parsed audience criteria with resolved Facebook reference IDs and validated parameters.

                IMPORTANT NOTES:
                - name, min_age and max_age are required, all other parameters are optional
                - Industries must be valid Facebook native industry names from the enum list
                - Countries must be valid country names from the platform's supported countries list
                - min_age and max_age must both be between 21 and 65, with min_age <= max_age
                - Job titles and interests are free-text arrays
                - Job titles and interests are validated by the backend API with the regex pattern [A-Za-z0-9 ]+ (only ASCII letters, digits, and spaces are allowed). Non-ASCII characters, hyphens, and special characters will be automatically replaced with spaces before resolving references (e.g., "co-founder" becomes "co founder"). When providing job titles or interests, use only alphanumeric characters and spaces.