---
title: "create_technographic_audience. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/create_technographic_audience
description: "Creates B2B audiences based on technology stack, software usage, and firmographic attributes. Writes tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# create_technographic_audience

Creates B2B audiences based on technology stack, software usage, and firmographic attributes.

Writes [audiences](https://metadata.io/developers/tools/#cat-audiences)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `name` | string | required | Audience name (required). Maximum 50 characters. |
| `technologies` | array | required | Array of technology names to target (required). Example: ['Salesforce', 'HubSpot', 'Marketo'] |
| `industries` | array |   | Industry IDs for firmographic/technographic filtering (optional). Valid IDs: 1=Defense & Space, 3=Computer Hardware, 4=Computer Software, 5=Computer Networking, 6=Internet, 7=Semiconductors, 8=Telecommunications, 9=Law Practice, 10=Legal Services, 11=Management Consulting, 12=Biotechnology, 13=Medic |
| `employees` | array |   | Employee count ranges for firmographic filtering (optional). Valid enum values: LESS_THAN_10 (0-9), FROM_10_TO_50 (10-49), FROM_50_TO_200 (50-199), FROM_200_TO_500 (200-499), FROM_500_TO_1000 (500-999), FROM_1000_TO_5000 (1,000-4,999), FROM_5000_TO_10000 (5,000-9,999), OVER_10000 (10,000+). Example: |
| `revenue` | array |   | Revenue ranges for firmographic filtering (optional). Valid enum values: LESS_THAN_1M ($0-$1M), FROM_1M_TO_10M ($1M-$10M), FROM_10M_TO_50M ($10M-$50M), FROM_50M_TO_100M ($50M-$100M), FROM_100M_TO_200M ($100M-$200M), FROM_200M_TO_500M ($200M-$500M), FROM_500M_TO_1000M ($500M-$1B), OVER_1000M ($1B+). |
| `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 |
| `estimate_only` | boolean |   | If true, do NOT create the audience — only estimate its size and return the counts. Use this when the user wants to preview how many companies/contacts match the criteria before committing. Defaults to false (audience is created). |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other audiences tools:

- [archive_audience](https://metadata.io/developers/tools/archive_audience) Destructive
- [create_audience_from_segment](https://metadata.io/developers/tools/create_audience_from_segment) Writes
- [create_bombora_audience](https://metadata.io/developers/tools/create_bombora_audience) Writes
- [create_csv_upload_linkedin_native_audience](https://metadata.io/developers/tools/create_csv_upload_linkedin_native_audience) Writes
- [create_facebook_native_criteria_audience](https://metadata.io/developers/tools/create_facebook_native_criteria_audience) Writes
- [create_firmographic_audience](https://metadata.io/developers/tools/create_firmographic_audience) Writes
- [create_g2_intent_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_dynamic_audience) Writes
- [create_g2_intent_linkedin_native_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_linkedin_native_dynamic_audience) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)