Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.
Create new audience — pass audience_name (+ file and/or contacts). Columns are taken from the uploaded file’s header row (or the first 50 JSON contacts rows) when no input_variables are passed.
Append to an existing audience — pass audience_id (+ file and/or contacts) to add more contacts into that audience. At least one contact row (file or contacts) is required.
Name of the new audience. Required when audience_id is not provided. Must be unique within the workspace.
audience_id
number
Yes*
ID of an existing audience to append contacts to. When provided, switches to append mode and audience_name is not required.
description
string
No
Free-text description. Ignored in append mode.
source
number
No
1 = CSV/Bulk Upload, 2 = Manual. Forced to 1 whenever a file is uploaded, regardless of what’s passed. Defaults to 2 when omitted and no file is uploaded. Ignored in append mode.
input_variables
array
No
Input-variable registry IDs to use as this audience’s columns, or an array of variable key strings directly (e.g. ["mobile_no","name"]). Also accepted as variable_id / variable_ids. Ignored in append mode.
tags
array
No
Free-form tags. Accepts an array, a JSON-string array, or a comma-separated string. Ignored in append mode.
is_global
boolean
No
1 = usable by any agent (default). 0 = agent-specific. Defaults to 0 when agent_id is passed without is_global. Ignored in append mode.
agent_id
number
No
Agent this audience is scoped to. Implies is_global = 0 unless is_global is explicitly set. Ignored in append mode.
contacts
array | JSON string
No
Contact rows as a JSON array of objects (each object’s keys become/must match the audience’s columns). Combines with an uploaded file if both are given.
audience
file
No
CSV/Excel file of contact rows — the multipart field name must be audience. The file’s header row supplies the column names. At least one of the file or contacts is required in append mode.
Rows are pulled from the uploaded file (multipart field audience) and/or the JSON contacts array and merged into one list before insert; large files insert in 500-row chunks.
If input_variables (or variable_id/variable_ids) were explicitly selected and a file is uploaded, the file’s header row must contain a column for every selected variable — values may be left blank, but the column must exist.
Appending contacts additionally requires the file to include a column for every one of the target audience’s existing input variables.
A row without a usable phone/mobile value is skipped; if every row is skipped, the request fails rather than silently creating an empty audience.
New contacts are automatically synced into any campaign (or segment) already connected to the audience.
Error Cases
Error
Cause
Audience Name is missing.
audience_name not provided when creating a new audience
Audience name already exists in this workspace
audience_name already used by another (non-deleted) audience in the workspace
Audience not found
audience_id (append mode) doesn’t belong to the caller’s company/workspace, or is deleted
No contacts provided
Append mode called with no file and no contacts rows
No valid contacts found — make sure the file has a phone/mobile column with values
None of the rows had a usable mobile number
The uploaded file is empty — add at least one contact with a phone/mobile number
Uploaded file parsed to zero rows (new audience mode)
Your file must include a column for every input variable in this audience. Column(s) "..." ... missing.
Upload is missing one or more of the required input-variable columns
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"UnleashX","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/unleashx/l9ieMCUF2RRzrBWV/logo/dark.png?fit=max\u0026auto=format\u0026n=l9ieMCUF2RRzrBWV\u0026q=85\u0026s=3a048a051528d675fc2a15d6f83f8755","dark":"https://mintcdn.com/unleashx/l9ieMCUF2RRzrBWV/logo/light.png?fit=max\u0026auto=format\u0026n=l9ieMCUF2RRzrBWV\u0026q=85\u0026s=2b9b7b9620627db81fab80ccff16cabd"},"favicon":"https://mintcdn.com/unleashx/UPxx_JBBmWXCTLNc/favicon.ico?fit=max\u0026auto=format\u0026n=UPxx_JBBmWXCTLNc\u0026q=85\u0026s=750f5cc3486a57581cf411d6af6f55f9","api":{"playground":{"proxy":false}},"navbar":{"links":[{"href":"https://unleashx.statuspage.io/","label":"Status"},{"href":"mailto:cs@unleashx.ai","label":"Support"}],"primary":{"type":"button","label":"Login","href":"https://www.tryunleashx.com"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://linkedin.com/company/mintlify"}},"integrations":{"ga4":{"measurementId":"G-9DMBVXZKY3"},"gtm":{"tagId":"GTM-W9XGJ8BD"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"unleashx","hasAudioNarration":false,"actualSubdomain":"unleashx","customDomains":["docs.unleashx.ai"],"gitSource":{"type":"github","owner":"pawanux","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{},"buildId":"6b02d6fcc5fffd200d2421b8","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Integrations","count":179},{"language":"default","tag":"Voice AI","count":53},{"language":"default","tag":"Evaluation","count":26},{"language":"default","tag":"Audience","count":23},{"language":"default","tag":"Productivity \u0026 Scheduling","count":18},{"language":"default","tag":"Campaigns","count":17},{"language":"default","tag":"Communication","count":14},{"language":"default","tag":"CRM \u0026 Marketing","count":13},{"language":"default","tag":"Voice","count":12},{"language":"default","tag":"FAQs","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/audience/create-audience","slug":"/api-reference/audience/create-audience","pageMetadata":{"title":"Create Audience","openapi":"api-reference/openapi.json POST /audience/create","description":"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.","href":"/api-reference/audience/create-audience"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint to `,_jsx(_components.strong,{children:`create a new audience, or append contacts to an existing one`}),`, from an uploaded file and/or a JSON contact list.`]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`POST`}),` `,_jsx(_components.code,{children:`/audience/create`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Content-Type:`}),` `,_jsx(_components.code,{children:`multipart/form-data`}),` (file upload) or `,_jsx(_components.code,{children:`application/json`}),` (JSON contacts only)\n`,_jsx(_components.strong,{children:`Authentication:`}),` Required (workspace auth)`]}),`\n`,_jsx(Heading,{level:`2`,id:`two-modes`,children:`Two Modes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Create new audience`}),` — pass `,_jsx(_components.code,{children:`audience_name`}),` (+ file and/or `,_jsx(_components.code,{children:`contacts`}),`). Columns are taken from the uploaded file’s header row (or the first 50 JSON `,_jsx(_components.code,{children:`contacts`}),` rows) when no `,_jsx(_components.code,{children:`input_variables`}),` are passed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Append to an existing audience`}),` — pass `,_jsx(_components.code,{children:`audience_id`}),` (+ file and/or `,_jsx(_components.code,{children:`contacts`}),`) to add more contacts into that audience. At least one contact row (file or `,_jsx(_components.code,{children:`contacts`}),`) is required.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsx(Heading,{level:`3`,id:`create-new-audience`,children:`Create new audience`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"audience_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VIP Customers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"High value customers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vip\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"renewal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"input_variables\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"contacts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"mobile_no\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+12025550123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"mobile_no\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+12025550456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane Smith\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`append-contacts-to-an-existing-audience`,children:`Append contacts to an existing audience`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"audience_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`55`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"contacts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"mobile_no\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+12025550789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Alex Kim\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`audience_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes*`}),_jsxs(_components.td,{children:[`Name of the new audience. Required when `,_jsx(_components.code,{children:`audience_id`}),` is not provided. Must be unique within the workspace.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`audience_id`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Yes*`}),_jsxs(_components.td,{children:[`ID of an existing audience to append contacts to. When provided, switches to append mode and `,_jsx(_components.code,{children:`audience_name`}),` is not required.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`description`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Free-text description. Ignored in append mode.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`source`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1`}),` = CSV/Bulk Upload, `,_jsx(_components.code,{children:`2`}),` = Manual. Forced to `,_jsx(_components.code,{children:`1`}),` whenever a file is uploaded, regardless of what’s passed. Defaults to `,_jsx(_components.code,{children:`2`}),` when omitted and no file is uploaded. Ignored in append mode.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`input_variables`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Input-variable registry IDs to use as this audience’s columns, `,_jsx(_components.strong,{children:`or`}),` an array of variable key strings directly (e.g. `,_jsx(_components.code,{children:`[\"mobile_no\",\"name\"]`}),`). Also accepted as `,_jsx(_components.code,{children:`variable_id`}),` / `,_jsx(_components.code,{children:`variable_ids`}),`. Ignored in append mode.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tags`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Free-form tags. Accepts an array, a JSON-string array, or a comma-separated string. Ignored in append mode.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_global`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1`}),` = usable by any agent (default). `,_jsx(_components.code,{children:`0`}),` = agent-specific. Defaults to `,_jsx(_components.code,{children:`0`}),` when `,_jsx(_components.code,{children:`agent_id`}),` is passed without `,_jsx(_components.code,{children:`is_global`}),`. Ignored in append mode.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_id`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Agent this audience is scoped to. Implies `,_jsx(_components.code,{children:`is_global = 0`}),` unless `,_jsx(_components.code,{children:`is_global`}),` is explicitly set. Ignored in append mode.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contacts`})}),_jsx(_components.td,{children:`array | JSON string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact rows as a JSON array of objects (each object’s keys become/must match the audience’s columns). Combines with an uploaded file if both are given.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`audience`})}),_jsx(_components.td,{children:`file`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`CSV/Excel file of contact rows — the multipart field name must be `,_jsx(_components.code,{children:`audience`}),`. The file’s header row supplies the column names. At least one of the file or `,_jsx(_components.code,{children:`contacts`}),` is required in append mode.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(Heading,{level:`3`,id:`new-audience-created`,children:`New audience created`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Audience created successfully\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`55`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"audience_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VIP Customers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_contacts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"input_variables\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mobile_no\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`contacts-appended`,children:`Contacts appended`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Contacts added to audience successfully\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`55`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"audience_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VIP Customers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_contacts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`behavior`,children:`Behavior`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Rows are pulled from the uploaded file (multipart field `,_jsx(_components.code,{children:`audience`}),`) and/or the JSON `,_jsx(_components.code,{children:`contacts`}),` array and merged into one list before insert; large files insert in 500-row chunks.`]}),`\n`,_jsxs(_components.li,{children:[`If `,_jsx(_components.code,{children:`input_variables`}),` (or `,_jsx(_components.code,{children:`variable_id`}),`/`,_jsx(_components.code,{children:`variable_ids`}),`) were explicitly selected and a file is uploaded, the file’s header row must contain a column for every selected variable — values may be left blank, but the column must exist.`]}),`\n`,_jsx(_components.li,{children:`Appending contacts additionally requires the file to include a column for every one of the target audience’s existing input variables.`}),`\n`,_jsx(_components.li,{children:`A row without a usable phone/mobile value is skipped; if every row is skipped, the request fails rather than silently creating an empty audience.`}),`\n`,_jsx(_components.li,{children:`New contacts are automatically synced into any campaign (or segment) already connected to the audience.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-cases`,children:`Error Cases`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Error`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Audience Name is missing.`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audience_name`}),` not provided when creating a new audience`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Audience name already exists in this workspace`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audience_name`}),` already used by another (non-deleted) audience in the workspace`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Audience not found`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audience_id`}),` (append mode) doesn’t belong to the caller’s company/workspace, or is deleted`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`No contacts provided`})}),_jsxs(_components.td,{children:[`Append mode called with no file and no `,_jsx(_components.code,{children:`contacts`}),` rows`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`No valid contacts found — make sure the file has a phone/mobile column with values`})}),_jsx(_components.td,{children:`None of the rows had a usable mobile number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`The uploaded file is empty — add at least one contact with a phone/mobile number`})}),_jsx(_components.td,{children:`Uploaded file parsed to zero rows (new audience mode)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Your file must include a column for every input variable in this audience. Column(s) \"...\" ... missing.`})}),_jsx(_components.td,{children:`Upload is missing one or more of the required input-variable columns`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`example-curl`,children:`Example cURL`}),`\n`,_jsx(Heading,{level:`3`,id:`json-contacts-only`,children:`JSON contacts only`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://www.tryunleashx.com/api/v1/global/audience/create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"token: \u003capi_key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"audience_name\": \"VIP Customers\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\": \"High value customers\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contacts\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"mobile_no\": \"+12025550123\", \"name\": \"John Doe\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"mobile_no\": \"+12025550456\", \"name\": \"Jane Smith\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`file-upload`,children:`File upload`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://www.tryunleashx.com/api/v1/global/audience/create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"token: \u003capi_key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"audience_name=VIP Customers\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"audience=@contacts.xlsx\"`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Audience","openapi":"api-reference/openapi.json POST /audience/create","description":"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.","href":"/api-reference/audience/create-audience"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Two Modes","slug":"two-modes","depth":2,"children":[]},{"title":"Request Body","slug":"request-body","depth":2,"children":[{"title":"Create new audience","slug":"create-new-audience","depth":3,"children":[]},{"title":"Append contacts to an existing audience","slug":"append-contacts-to-an-existing-audience","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"New audience created","slug":"new-audience-created","depth":3,"children":[]},{"title":"Contacts appended","slug":"contacts-appended","depth":3,"children":[]}]},{"title":"Behavior","slug":"behavior","depth":2,"children":[]},{"title":"Error Cases","slug":"error-cases","depth":2,"children":[]},{"title":"Example cURL","slug":"example-curl","depth":2,"children":[{"title":"JSON contacts only","slug":"json-contacts-only","depth":3,"children":[]},{"title":"File upload","slug":"file-upload","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create audience","description":"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.","tags":["Audience"],"security":[],"parameters":["e37d783d-260b-43de-a176-587432f4332c"],"requestBody":"fac8319b-ee5e-47c1-94a0-5e74ccc1078c","responses":{"200":"4b357ea1-c362-451a-b88c-029461dd6f93","400":"363d26e7-50a3-4b59-959b-fea5d53a5e08","401":"eff5a678-37db-4367-a450-8858f2b928a2","404":"86b3afd1-7274-40d2-80c5-666dcfed0dc9"},"method":"post","type":"path","servers":["95fa10df-9109-4d69-9989-2279d8d57ca2"],"path":"/audience/create","baseUrlOptions":["https://www.tryunleashx.com/api/v1/global/"],"title":"Create audience","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"e37d783d-260b-43de-a176-587432f4332c":{"name":"token","in":"header","required":true,"description":"API token for authentication","schema":{"type":"string","isRequired":true,"description":"API token for authentication","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audience_name":{"type":"string","description":"Name of the new audience. Required when audience_id is not provided. Must be unique within the workspace.","uniqueKey":"audience_name","typeLabel":"string"},"audience_id":{"type":"integer","description":"ID of an existing audience to append contacts to. Switches the request into append mode.","uniqueKey":"audience_id","typeLabel":"integer"},"description":{"type":"string","description":"Free-text description. Ignored in append mode.","uniqueKey":"description","typeLabel":"string"},"source":{"type":"integer","enum":[1,2],"description":"1=CSV/Bulk Upload, 2=Manual. Forced to 1 when a file is uploaded. Ignored in append mode.","uniqueKey":"source","typeLabel":"enum\u003cinteger>"},"input_variables":{"type":"array","items":{"oneOf":[{"type":"integer","description":"Input-variable registry ID","uniqueKey":"input_variables.items.[INDEX].oneOf.0","typeLabel":"integer"},{"type":"string","description":"Variable key","uniqueKey":"input_variables.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"input_variables.items.[INDEX]","typeLabel":"integer | string"},"example":[12,15],"description":"Input-variable registry IDs, or an array of variable key strings directly. Also accepted as variable_id / variable_ids. Ignored in append mode.","uniqueKey":"input_variables","typeLabel":"(integer | string)[]"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"Free-form tags. Ignored in append mode.","uniqueKey":"tags","typeLabel":"string[]"},"is_global":{"type":"boolean","description":"1 = usable by any agent (default), 0 = agent-specific. Ignored in append mode.","uniqueKey":"is_global","typeLabel":"boolean"},"agent_id":{"type":"integer","description":"Agent this audience is scoped to. Implies is_global=0 unless is_global is explicitly set. Ignored in append mode.","uniqueKey":"agent_id","typeLabel":"integer"},"contacts":{"type":"array","items":{"type":"object","uniqueKey":"contacts.items.[INDEX]","typeLabel":"object"},"description":"Contact rows as an array of objects, e.g. [{\"mobile_no\":\"+12025550123\",\"name\":\"John Doe\"}]. Combines with an uploaded file if both are given.","uniqueKey":"contacts","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"audience_name":"\u003cstring>","audience_id":123,"description":"\u003cstring>","input_variables":[12,15],"tags":["\u003cstring>"],"is_global":true,"agent_id":123,"contacts":[{}]}}},"exampleType":"generated"},"multipart/form-data":{"schema":{"type":"object","properties":{"audience_name":{"type":"string","uniqueKey":"audience_name","typeLabel":"string"},"audience_id":{"type":"integer","uniqueKey":"audience_id","typeLabel":"integer"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"source":{"type":"integer","enum":[1,2],"uniqueKey":"source","typeLabel":"enum\u003cinteger>"},"input_variables":{"type":"string","description":"JSON-string array of registry IDs or variable keys, or a comma-separated list","uniqueKey":"input_variables","typeLabel":"string"},"tags":{"type":"string","description":"JSON-string array or comma-separated list","uniqueKey":"tags","typeLabel":"string"},"is_global":{"type":"boolean","uniqueKey":"is_global","typeLabel":"boolean"},"agent_id":{"type":"integer","uniqueKey":"agent_id","typeLabel":"integer"},"contacts":{"type":"string","description":"JSON-string array of contact objects","uniqueKey":"contacts","typeLabel":"string"},"audience":{"type":"string","format":"binary","description":"CSV/Excel file of contact rows. The multipart field name must be 'audience'; its header row supplies the column names.","uniqueKey":"audience","typeLabel":"file"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"audience_name":"\u003cstring>","audience_id":123,"description":"\u003cstring>","input_variables":"\u003cstring>","tags":"\u003cstring>","is_global":true,"agent_id":123,"contacts":"\u003cstring>","audience":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4b357ea1-c362-451a-b88c-029461dd6f93":{"description":"Audience created, or contacts appended, successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"data.id","typeLabel":"integer"},"audience_name":{"type":"string","uniqueKey":"data.audience_name","typeLabel":"string"},"total_contacts":{"type":"integer","uniqueKey":"data.total_contacts","typeLabel":"integer"},"input_variables":{"type":"array","items":{"type":"string","uniqueKey":"data.input_variables.items.[INDEX]","typeLabel":"string"},"description":"Only present when a new audience was created","uniqueKey":"data.input_variables","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","data":{"id":123,"audience_name":"\u003cstring>","total_contacts":123,"input_variables":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"363d26e7-50a3-4b59-959b-fea5d53a5e08":{"description":"Audience Name is missing. / Audience name already exists in this workspace / No contacts provided / No valid contacts found / The uploaded file is empty / a required input-variable column is missing from the upload","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"eff5a678-37db-4367-a450-8858f2b928a2":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"86b3afd1-7274-40d2-80c5-666dcfed0dc9":{"description":"Audience not found (append mode, invalid audience_id)","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{"95fa10df-9109-4d69-9989-2279d8d57ca2":{"url":"https://www.tryunleashx.com/api/v1/global/"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"unleashx","siteName":"UnleashX","title":"Create Audience - UnleashX","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T04:42:17.068Z","originalFileLocation":"api-reference/audience/create-audience.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"UnleashX\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Audience - UnleashX\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"UnleashX\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.unleashx.ai/api-reference/audience/create-audience\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://unleashx.mintlify.site/_mintlify/api/og/v2?division=Audience\u0026amp;title=Create+Audience\u0026amp;description=Create+a+new+audience+from+an+uploaded+file+and%2For+a+JSON+contacts+array+%28pass+audience_name%29%2C+or+append+contacts+to+an+existing+audience+%28pass+audience_id%29.+Ro\u0026amp;theme=14d87b61cd27b672f6866c82\u0026amp;signature=a3a56b996653f4257361d3ff31249f72734869b562a02f126e1ccf347798419e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Audience - UnleashX\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://unleashx.mintlify.site/_mintlify/api/og/v2?division=Audience\u0026amp;title=Create+Audience\u0026amp;description=Create+a+new+audience+from+an+uploaded+file+and%2For+a+JSON+contacts+array+%28pass+audience_name%29%2C+or+append+contacts+to+an+existing+audience+%28pass+audience_id%29.+Ro\u0026amp;theme=14d87b61cd27b672f6866c82\u0026amp;signature=a3a56b996653f4257361d3ff31249f72734869b562a02f126e1ccf347798419e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/unleashx/AFUatSBxYcnCxJZg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"UnleashX\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.unleashx.ai/api-reference/audience/create-audience\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/audience/create-audience.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.unleashx.ai/#organization\",\"name\":\"UnleashX\",\"url\":\"https://docs.unleashx.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/unleashx/l9ieMCUF2RRzrBWV/logo/dark.png?fit=max\u0026auto=format\u0026n=l9ieMCUF2RRzrBWV\u0026q=85\u0026s=3a048a051528d675fc2a15d6f83f8755\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.unleashx.ai#website\",\"name\":\"UnleashX\",\"url\":\"https://docs.unleashx.ai\",\"publisher\":{\"@id\":\"https://docs.unleashx.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.unleashx.ai/api-reference/audience/create-audience#webpage\",\"url\":\"https://docs.unleashx.ai/api-reference/audience/create-audience\",\"name\":\"Create Audience\",\"description\":\"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.\",\"dateModified\":\"2026-11-17T04:42:17.068Z\",\"isPartOf\":{\"@id\":\"https://docs.unleashx.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.unleashx.ai/api-reference/audience/create-audience#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.unleashx.ai/api-reference/audience/create-audience#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Audience\",\"item\":\"https://docs.unleashx.ai/api-reference/audience\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Audience\",\"item\":\"https://docs.unleashx.ai/api-reference/audience/create-audience\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.unleashx.ai/api-reference/audience/create-audience#apireference\",\"headline\":\"Create Audience\",\"name\":\"Create Audience\",\"description\":\"Create a new audience from an uploaded file and/or a JSON contacts array (pass audience_name), or append contacts to an existing audience (pass audience_id). Rows are collected from the uploaded file and/or the contacts array; rows without a usable mobile number are skipped, and every campaign/segment already connected to the audience is synced with the newly added contacts.\",\"url\":\"https://docs.unleashx.ai/api-reference/audience/create-audience\",\"mainEntityOfPage\":{\"@id\":\"https://docs.unleashx.ai/api-reference/audience/create-audience#webpage\"},\"dateModified\":\"2026-11-17T04:42:17.068Z\",\"publisher\":{\"@id\":\"https://docs.unleashx.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.unleashx.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"UnleashX\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"UnleashX\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/audience/create-audience.md","siteName":"UnleashX","nav":{"global":null,"tabs":[{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Voice AI","groups":[{"group":"Overview","pages":[{"title":"Voice AI","href":"/api-reference/voice-ai"}]},{"group":"Voice","pages":[{"title":"Create Voice Agent","openapi":"api-reference/openapi.json POST /create-agent","href":"/api-reference/voice-ai/create-voice-agent"},{"title":"Update Voice Agent","openapi":"api-reference/openapi.json POST /create-agent","href":"/api-reference/voice-ai/update-voice-agent"},{"title":"Delete Voice Agent","openapi":"api-reference/openapi.json POST /delete-agent","href":"/api-reference/voice-ai/delete-voice-agent"},{"title":"List Voice Agents","openapi":"api-reference/openapi.json GET /agents/get","href":"/api-reference/voice-ai/list-voice-agents"},{"title":"Get Agent Details by ID","openapi":"api-reference/openapi.json GET /agents/get-by-id","href":"/api-reference/voice-ai/get-agent-by-id"},{"title":"Attach Phone Number","openapi":"api-reference/openapi.json POST /attach-phone-numbers","href":"/api-reference/voice-ai/attach-phone-number"},{"title":"Make Call","openapi":"api-reference/openapi.json POST /agents/call","href":"/api-reference/voice-ai/make-call"},{"title":"List Voices","openapi":"api-reference/openapi.json GET /voice-list","href":"/api-reference/voice-ai/list-voices"},{"group":"Phone Numbers","pages":[{"title":"List Phone Numbers","openapi":"api-reference/openapi.json GET /list-phone-numbers","href":"/api-reference/phone-numbers/list-phone-numbers"}]},{"group":"Call Logs","pages":[{"title":"Call History","openapi":"api-reference/openapi.json GET /agents/call-history","href":"/api-reference/call-logs"},{"title":"Call Summary(Agent Wise)","openapi":"api-reference/openapi.json GET /agents/executions/list","href":"/api-reference/call-logs/call-summary"},{"title":"Call Cost","openapi":"api-reference/openapi.json GET /transactions/calling-list-with-transaction","href":"/api-reference/call-logs/call-cost"}]}]},{"group":"Campaigns","pages":[{"title":"Overview","href":"/api-reference/campaigns"},{"title":"Create Campaign","openapi":"api-reference/openapi.json POST /create-campaign","href":"/api-reference/campaigns/create-campaign"},{"title":"Update Campaign","openapi":"api-reference/openapi.json POST /update-campaign","href":"/api-reference/campaigns/update-campaign"},{"title":"Force Complete Campaign","openapi":"api-reference/openapi.json POST /campaign-force-completed","href":"/api-reference/campaigns/campaign-force-completed"},{"title":"List Campaigns","openapi":"api-reference/openapi.json GET /campaign-list","href":"/api-reference/campaigns/campaign-list"},{"title":"Campaign Summary List","openapi":"api-reference/openapi.json GET /summary-list","href":"/api-reference/campaigns/campaign-summary-list"},{"title":"Campaign Consumption","openapi":"api-reference/openapi.json GET /campaign-consumption","href":"/api-reference/campaigns/campaign-consumption"},{"title":"Campaign Details","openapi":"api-reference/openapi.json GET /campaign-details/{campaign_id}","href":"/api-reference/campaigns/campaign-details"},{"title":"Audience List","openapi":"api-reference/openapi.json GET /audience-list","href":"/api-reference/campaigns/audience-list"},{"title":"Download Audience Format","openapi":"api-reference/openapi.json GET /audience-format","href":"/api-reference/campaigns/audience-format"},{"title":"Update Knowledge Base Status","openapi":"api-reference/openapi.json POST /update-knowledgebase-status","href":"/api-reference/campaigns/update-knowledgebase-status"},{"title":"Campaign Audience Stats","openapi":"api-reference/openapi.json GET /campaign-audience-stats","href":"/api-reference/campaigns/campaign-audience-stats"},{"title":"Delete Audience","openapi":"api-reference/openapi.json POST /delete-audience","href":"/api-reference/campaigns/delete-audience"},{"title":"Export Campaign Data","openapi":"api-reference/openapi.json GET /export-campaign-data","href":"/api-reference/campaigns/export-campaign-data"},{"title":"Export Campaign Audience Data","openapi":"api-reference/openapi.json GET /export-campaign-audience-data","href":"/api-reference/campaigns/export-campaign-audience-data"},{"title":"Attach Campaign Sources","openapi":"api-reference/openapi.json POST /campaign/attach-sources","href":"/api-reference/campaigns/attach-campaign-sources"},{"title":"Campaign Connected Contacts","openapi":"api-reference/openapi.json GET /campaign/contacts-list","href":"/api-reference/campaigns/campaign-connected-contacts"}]},{"group":"Audience","pages":[{"title":"Overview","description":null,"href":"/api-reference/audience"},{"title":"Create Audience","openapi":"api-reference/openapi.json POST /audience/create","href":"/api-reference/audience/create-audience"},{"title":"Update Audience","openapi":"api-reference/openapi.json POST /audience/update","description":"Rename or describe an existing audience, or soft-delete it by passing status: 2.","href":"/api-reference/audience/update-audience"},{"title":"List Audiences","openapi":"api-reference/openapi.json GET /audience/list","href":"/api-reference/audience/list-audiences"},{"title":"Audience Summary List","openapi":"api-reference/openapi.json GET /audience/summary-list","href":"/api-reference/audience/audience-summary-list"},{"title":"Audience Details","openapi":"api-reference/openapi.json GET /audience/details","href":"/api-reference/audience/audience-details"},{"title":"List Audience Contacts","openapi":"api-reference/openapi.json GET /audience/contacts","href":"/api-reference/audience/list-audience-contacts"},{"title":"Export Audience Contacts","openapi":"api-reference/openapi.json GET /audience/contacts/export","href":"/api-reference/audience/export-audience-contacts"},{"title":"Delete Audience Contacts","openapi":"api-reference/openapi.json POST /audience/delete-contacts","href":"/api-reference/audience/delete-audience-contacts"},{"title":"Download Audience Template","openapi":"api-reference/openapi.json GET /audience/download-template","href":"/api-reference/audience/download-audience-template"},{"group":"Segment","pages":[{"title":"Overview","href":"/api-reference/segment"},{"title":"Create Segment","openapi":"api-reference/openapi.json POST /segment/create","href":"/api-reference/segment/create-segment"},{"title":"Preview Segment","openapi":"api-reference/openapi.json POST /segment/preview","href":"/api-reference/segment/preview-segment"},{"title":"List Segments","openapi":"api-reference/openapi.json GET /segment/list","href":"/api-reference/segment/list-segments"},{"title":"Segment Summary List","openapi":"api-reference/openapi.json GET /segment/summary-list","href":"/api-reference/segment/segment-summary-list"},{"title":"Segment Details","openapi":"api-reference/openapi.json GET /segment/details","href":"/api-reference/segment/segment-details"},{"title":"Update Segment","openapi":"api-reference/openapi.json POST /segment/update","href":"/api-reference/segment/update-segment"},{"title":"List Segment Contacts","openapi":"api-reference/openapi.json GET /segment/contacts","href":"/api-reference/segment/list-segment-contacts"},{"title":"Export Segment Contacts","openapi":"api-reference/openapi.json GET /segment/contacts/export","href":"/api-reference/segment/export-segment-contacts"}]},{"group":"Input Variables","pages":[{"title":"Overview","href":"/api-reference/input-variables"},{"title":"Create Input Variable","openapi":"api-reference/openapi.json POST /input-variable/create","href":"/api-reference/input-variables/create-input-variable"},{"title":"List Input Variables","openapi":"api-reference/openapi.json GET /input-variable/list","href":"/api-reference/input-variables/list-input-variables"},{"title":"Update Input Variable","openapi":"api-reference/openapi.json POST /input-variable/update","href":"/api-reference/input-variables/update-input-variable"}]}]}]},{"tab":"Click to Call","pages":[{"title":"Click to Call","href":"/api-reference/click-to-dial/overview"}]},{"tab":"Evaluation","pages":[{"title":"Evaluation","href":"/api-reference/evaluation"}]},{"tab":"Workflows","pages":[{"title":"Workflows","href":"/api-reference/workflows"}]},{"tab":"Chatbots","pages":[{"title":"Chatbots","href":"/api-reference/chatbots"}]},{"tab":"Apps \u0026 Data","pages":[{"title":"Apps \u0026 Data","href":"/api-reference/forms"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs/platform-guide"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/releases"}]}]},"basePath":"","title":"Create Audience - UnleashX","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","CodeSnippet-B373COAT.js","getApiPlaygroundDisplay-CfL-UuDS.js","Page-DuqezyvM.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}