{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Conversion Docs","colors":{"primary":"#2C789F","light":"#3791C0","dark":"#225E7D"},"logo":{"light":"https://mintcdn.com/conversion/M0RNTMA370yH2H5Y/logo/light.svg?fit=max\u0026auto=format\u0026n=M0RNTMA370yH2H5Y\u0026q=85\u0026s=dd94915bb123e2ceb1ca67d31e896f3a","dark":"https://mintcdn.com/conversion/M0RNTMA370yH2H5Y/logo/dark.svg?fit=max\u0026auto=format\u0026n=M0RNTMA370yH2H5Y\u0026q=85\u0026s=2020c26ba331777bd667dcef815a57b2"},"favicon":"https://mintcdn.com/conversion/T2lj7tkL3i8HhLKA/favicon.svg?fit=max\u0026auto=format\u0026n=T2lj7tkL3i8HhLKA\u0026q=85\u0026s=d005c78403dd8b918a4768e913932fe4","api":{"playground":{"display":"interactive"}},"navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://app.conversion.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/tryconversion","x":"https://x.com/tryconversion","instagram":"https://www.instagram.com/tryconversion","youtube":"https://www.youtube.com/@tryconversion"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"conversion","hasAudioNarration":false,"actualSubdomain":"conversion","customDomains":["docs.conversion.ai"],"gitSource":{"type":"github","owner":"tapp-ai","repo":"mega","deployBranch":"main","contentDirectory":"product-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af63717ac5cf20351d85527","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Product Docs","count":227},{"language":"default","tag":"Workspace Settings","count":44},{"language":"default","tag":"Workflows","count":35},{"language":"default","tag":"Campaigns","count":34},{"language":"default","tag":"API Reference","count":32},{"language":"default","tag":"Nodes","count":25},{"language":"default","tag":"Data Syncing","count":23},{"language":"default","tag":"Forms","count":19},{"language":"default","tag":"Conversion AI","count":17},{"language":"default","tag":"Records","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/add-contact-to-audience","slug":"/api-reference/add-contact-to-audience","pageMetadata":{"title":"Add Contact to Audience","description":"Add a contact to a static audience. The contact is identified by `cnvContactId`, `userId`, or `email`.","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/audiences/{audienceId}/contacts","href":"/api-reference/add-contact-to-audience","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Add a contact to a static audience. The contact is identified by \", _jsx(_components.code, {\n children: \"cnvContactId\"\n }), \", \", _jsx(_components.code, {\n children: \"userId\"\n }), \", or \", _jsx(_components.code, {\n children: \"email\"\n }), \".\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add Contact to Audience","description":"Add a contact to a static audience. The contact is identified by `cnvContactId`, `userId`, or `email`.","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/audiences/{audienceId}/contacts","href":"/api-reference/add-contact-to-audience","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"addContactToAudience","summary":"Add Contact to Audience","description":"Add a contact to a static audience. The contact is identified by `cnvContactId`, `userId`, or `email`.","parameters":["3a0da55f-243d-4ce4-a59d-0f8a1ef55a6b"],"requestBody":"21c25718-26fd-4da5-8579-11e5d7402dd5","responses":{"200":"25fe9c5b-3246-41ed-a6b5-3d6a32ec5d57","400":"91a42fee-01d1-420e-88de-5496c4aaaab4","401":"e6dfde49-855e-4114-90f0-a5f6a151512d","404":"294dae1a-e746-4e08-b7bb-234a2064b061","409":"2671b681-9f56-40dd-a6d8-91c2c1491756","500":"4b4cdaa3-fa21-420e-99ac-bd37bdd68fe2"},"method":"post","type":"path","servers":["e3ed283f-d0eb-4402-99e1-063950ef0c3a"],"security":["2a3d928d-44fb-4185-a55c-18ac68131732","7b695cb3-04d3-40ee-9fe0-469752c5abf3"],"path":"/v2/audiences/{audienceId}/contacts","baseUrlOptions":["https://pub-api.conversion.ai/api"],"title":"Add Contact to Audience","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3a0da55f-243d-4ce4-a59d-0f8a1ef55a6b":{"name":"audienceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The ID of the static audience to add the contact to.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"The ID of the static audience to add the contact to.","examples":{"example":{"value":"d4e5f6a7-b8c9-0123-def0-456789abcdef"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"The contact's email address. At least one of `cnvContactId`, `userId`, or `email` is required.","examples":["jane@example.com"],"uniqueKey":"email","typeLabel":"string\u003cemail>"},"cnvContactId":{"type":"string","format":"uuid","description":"The Conversion contact ID. At least one of `cnvContactId`, `userId`, or `email` is required.","examples":["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],"uniqueKey":"cnvContactId","typeLabel":"string\u003cuuid>"},"userId":{"type":"string","description":"An external user identifier for the contact. At least one of `cnvContactId`, `userId`, or `email` is required.","examples":["user_12345"],"uniqueKey":"userId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"add-by-email":{"title":"add-by-email","value":{"email":"jane@example.com"}},"add-by-contact-id":{"title":"add-by-contact-id","value":{"cnvContactId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}},"add-by-userId":{"title":"add-by-userId","value":{"userId":"user_12345"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"25fe9c5b-3246-41ed-a6b5-3d6a32ec5d57":{"description":"Contact added to the audience successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["added","cnvContactId"],"properties":{"added":{"type":"boolean","description":"`true` once the contact is a member of the audience. The operation is idempotent.","isRequired":true,"uniqueKey":"data.added","typeLabel":"boolean"},"cnvContactId":{"type":"string","format":"uuid","description":"The resolved Conversion contact ID.","isRequired":true,"uniqueKey":"data.cnvContactId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"added":{"title":"added","value":{"data":{"added":true,"cnvContactId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}}}},"exampleType":"examples"}},"exampleType":"examples"},"91a42fee-01d1-420e-88de-5496c4aaaab4":{"description":"The request was malformed or the audience cannot accept contacts directly.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A machine-readable error code.","examples":["invalid_email"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human-readable error description.","examples":["invalid email format: not-an-email"],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing-identifier":{"title":"missing-identifier","value":{"error":{"code":"missing_identifier","message":"at least one of cnvContactId, userId, or email is required"}}},"audience-not-static":{"title":"audience-not-static","value":{"error":{"code":"audience_not_static","message":"contacts can only be added to static audiences"}}}},"exampleType":"examples"}},"exampleType":"examples"},"e6dfde49-855e-4114-90f0-a5f6a151512d":{"description":"Authentication failed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A machine-readable error code.","examples":["invalid_email"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human-readable error description.","examples":["invalid email format: not-an-email"],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unauthorized":{"title":"unauthorized","value":{"error":{"code":"unauthorized","message":"API key is required"}}}},"exampleType":"examples"}},"exampleType":"examples"},"294dae1a-e746-4e08-b7bb-234a2064b061":{"description":"The audience or contact was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A machine-readable error code.","examples":["invalid_email"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human-readable error description.","examples":["invalid email format: not-an-email"],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"audience-not-found":{"title":"audience-not-found","value":{"error":{"code":"audience_not_found","message":"audience not found"}}},"contact-not-found":{"title":"contact-not-found","value":{"error":{"code":"contact_not_found","message":"no contact found matching the provided identifier"}}}},"exampleType":"examples"}},"exampleType":"examples"},"2671b681-9f56-40dd-a6d8-91c2c1491756":{"description":"The provided identifiers conflict with an existing contact.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A machine-readable error code.","examples":["invalid_email"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human-readable error description.","examples":["invalid email format: not-an-email"],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"conflicting-identifier":{"title":"conflicting-identifier","value":{"error":{"code":"conflicting_identifier","message":"contact found by email but has a different userId"}}}},"exampleType":"examples"}},"exampleType":"examples"},"4b4cdaa3-fa21-420e-99ac-bd37bdd68fe2":{"description":"An unexpected server error occurred.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"A machine-readable error code.","examples":["invalid_email"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human-readable error description.","examples":["invalid email format: not-an-email"],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"internal":{"title":"internal","value":{"error":{"code":"internal_error","message":"failed to add contact to audience"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"2a3d928d-44fb-4185-a55c-18ac68131732":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your Conversion API key. Found in **Settings > Integrations** in the dashboard. Format: `sk_live_\u003ckey_id>_\u003csecret>`.","scopes":[],"schemeName":"apiKey"}},"7b695cb3-04d3-40ee-9fe0-469752c5abf3":{"apiKeyQuery":{"type":"apiKey","in":"query","name":"api_key","description":"Your Conversion API key, sent as a query parameter instead of the `X-API-Key` header. Prefer the header: URLs can end up in logs and browser history.","scopes":[],"schemeName":"apiKeyQuery"}}},"servers":{"e3ed283f-d0eb-4402-99e1-063950ef0c3a":{"url":"https://pub-api.conversion.ai/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your Conversion API key. Found in **Settings > Integrations** in the dashboard. Format: `sk_live_\u003ckey_id>_\u003csecret>`.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-API-Key","type":"string","description":"Your Conversion API key. Found in **Settings > Integrations** in the dashboard. Format: `sk_live_\u003ckey_id>_\u003csecret>`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-Key"}],"title":"apiKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"api_key","description":"Your Conversion API key, sent as a query parameter instead of the `X-API-Key` header. Prefer the header: URLs can end up in logs and browser history.","scopes":[],"schemeName":"apiKeyQuery"},"schema":{"title":"api_key","type":"string","description":"Your Conversion API key, sent as a query parameter instead of the `X-API-Key` header. Prefer the header: URLs can end up in logs and browser history.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyQuery","name":"api_key"}],"title":"apiKeyQuery"}]},"originalFileLocation":"openapi.json"},"subdomain":"conversion","siteName":"Conversion Docs","title":"Add Contact to Audience - Conversion Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T00:57:19.815Z","originalFileLocation":"api-reference/add-contact-to-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=\"Add a contact to a static audience. The contact is identified by cnvContactId, userId, or email.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Conversion Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_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/conversion/sLGaUqkRMoGSOJ-R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add Contact to Audience - Conversion Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a contact to a static audience. The contact is identified by cnvContactId, userId, or email.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Conversion Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.conversion.ai/api-reference/add-contact-to-audience\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://conversion.mintlify.site/_mintlify/api/og/v2?division=Audiences\u0026amp;title=Add+Contact+to+Audience\u0026amp;description=Add+a+contact+to+a+static+audience.+The+contact+is+identified+by+%60cnvContactId%60%2C+%60userId%60%2C+or+%60email%60.\u0026amp;theme=d8788a8349fc61d29bb2579b\u0026amp;signature=971df2acf24b495a1fee4932164e22c4bba91c2a6529cd8033043345551e1850\">\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=\"Add Contact to Audience - Conversion Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a contact to a static audience. The contact is identified by cnvContactId, userId, or email.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://conversion.mintlify.site/_mintlify/api/og/v2?division=Audiences\u0026amp;title=Add+Contact+to+Audience\u0026amp;description=Add+a+contact+to+a+static+audience.+The+contact+is+identified+by+%60cnvContactId%60%2C+%60userId%60%2C+or+%60email%60.\u0026amp;theme=d8788a8349fc61d29bb2579b\u0026amp;signature=971df2acf24b495a1fee4932164e22c4bba91c2a6529cd8033043345551e1850\">\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/conversion/sLGaUqkRMoGSOJ-R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Conversion Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2C789F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.conversion.ai/api-reference/add-contact-to-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/add-contact-to-audience.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.conversion.ai/#organization\",\"name\":\"Conversion Docs\",\"url\":\"https://docs.conversion.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/conversion/M0RNTMA370yH2H5Y/logo/light.svg?fit=max\u0026auto=format\u0026n=M0RNTMA370yH2H5Y\u0026q=85\u0026s=dd94915bb123e2ceb1ca67d31e896f3a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.conversion.ai#website\",\"name\":\"Conversion Docs\",\"url\":\"https://docs.conversion.ai\",\"publisher\":{\"@id\":\"https://docs.conversion.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience#webpage\",\"url\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience\",\"name\":\"Add Contact to Audience\",\"description\":\"Add a contact to a static audience. The contact is identified by cnvContactId, userId, or email.\",\"dateModified\":\"2026-11-06T00:57:19.815Z\",\"isPartOf\":{\"@id\":\"https://docs.conversion.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conversion Docs\",\"item\":\"https://docs.conversion.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add Contact to Audience\",\"item\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience#apireference\",\"headline\":\"Add Contact to Audience\",\"name\":\"Add Contact to Audience\",\"description\":\"Add a contact to a static audience. The contact is identified by cnvContactId, userId, or email.\",\"url\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience\",\"mainEntityOfPage\":{\"@id\":\"https://docs.conversion.ai/api-reference/add-contact-to-audience#webpage\"},\"dateModified\":\"2026-11-06T00:57:19.815Z\",\"publisher\":{\"@id\":\"https://docs.conversion.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.conversion.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Conversion Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Conversion Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/add-contact-to-audience.md","siteName":"Conversion Docs","nav":{"global":null,"tabs":[{"tab":"Product Docs","pages":[{"title":"Product Docs","href":"/product-docs/introduction"}]},{"tab":"Conversion AI","pages":[{"title":"Conversion AI","href":"/product-docs/conversion-ai/introduction"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Contacts","pages":[{"title":"Upsert Contact","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/contacts","href":"/api-reference/upsert-contact"},{"title":"Batch Upsert Contacts","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/contacts/batch","href":"/api-reference/batch-upsert-contacts"},{"title":"Get Contact","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/contacts","href":"/api-reference/get-contact"}]},{"group":"Events","pages":[{"title":"Track Event","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/events","href":"/api-reference/track-event"},{"title":"Batch Track Events","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/events/batch","href":"/api-reference/batch-track-events"}]},{"group":"Workflows","pages":[{"title":"Trigger Workflow","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/workflows/{workflowId}/trigger","href":"/api-reference/trigger-workflow"}]},{"group":"Fields","pages":[{"title":"List Fields","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/fields","href":"/api-reference/list-fields"},{"title":"Create Field","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/fields","href":"/api-reference/create-field"},{"title":"Create Relationship Fields","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/fields/relationships","href":"/api-reference/create-relationship-fields"}]},{"group":"Custom Objects","pages":[{"title":"Batch Upsert Custom Object Records","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/custom-objects/{customObjectId}/records/batch","href":"/api-reference/batch-upsert-custom-object-records"}]},{"group":"Forms","pages":[{"title":"List Forms","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/forms","href":"/api-reference/list-forms"},{"title":"Get Form","description":"Get a tracked, published Conversion-native form by id, including the fields of its published definition. Each field's `fieldId` is the key used to reference the field in the forms JavaScript API and in submission data. `DROPDOWN` and `MULTI_CHECKBOX` fields also list their selectable `options`, so you can map a submitted value back to the option label a visitor saw. A `MULTI_CHECKBOX` submits the values of every ticked option as a single semicolon-separated string, such as `analytics;automation`.\n\nOnly tracked, published Conversion-native forms resolve; unknown ids, forms belonging to another workspace, external and ad forms, and untracked, archived, or never-published forms all return a `form_not_found` error.","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/forms/{formId}","href":"/api-reference/get-form"}]},{"group":"Audiences","pages":[{"title":"Add Contact to Audience","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/audiences/{audienceId}/contacts","href":"/api-reference/add-contact-to-audience"},{"title":"Remove Contact from Audience","description":"Remove a contact from one static audience, identified by cnvContactId, userId, or email, in that order. Does not delete the contact, update fields, change subscription status, or remove other audience memberships. Returns success if the contact or membership is already absent. Requires audience edit permission.","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/audiences/{audienceId}/contacts","href":"/api-reference/remove-contact-from-audience"}]},{"group":"Campaigns","pages":[{"title":"List Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/campaigns","href":"/api-reference/list-campaigns"},{"title":"Get Campaign","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/campaigns/{campaignId}","href":"/api-reference/get-campaign"},{"title":"Add Campaign Member","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/campaigns/{campaignId}/members","href":"/api-reference/add-campaign-member"},{"title":"Batch Add Campaign Members","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/campaigns/{campaignId}/members/batch","href":"/api-reference/batch-add-campaign-members"}]},{"group":"Exports","pages":[{"title":"Export Contacts","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/contacts","href":"/api-reference/export-contacts"},{"title":"Export Email Events","deprecated":true,"version":null,"openapi":"/openapi.json post /v2/exports/email-events","href":"/api-reference/export-email-events"},{"title":"Export Custom Events","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/custom-events","href":"/api-reference/export-custom-events"},{"title":"Export Contact Events","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/contact-events","href":"/api-reference/export-contact-events"},{"title":"Export Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/campaigns","href":"/api-reference/export-campaigns"},{"title":"Export Campaign Types","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/campaign-types","href":"/api-reference/export-campaign-types"},{"title":"Export Workflows","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/workflows","href":"/api-reference/export-workflows"},{"title":"Export Audiences","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/audiences","href":"/api-reference/export-audiences"},{"title":"Export Audience Members","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/audience-members","href":"/api-reference/export-audience-members"},{"title":"Export Touchpoints","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/exports/touchpoints","href":"/api-reference/export-touchpoints"}]},{"group":"Privacy","pages":[{"title":"Full Delete Contact","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/full-delete","href":"/api-reference/full-delete-contact"}]},{"group":"Zapier","pages":[{"title":"Zapier Overview","sidebarTitle":"Overview","href":"/api-reference/zapier/overview"}]}]}]},"basePath":"","title":"Add Contact to Audience - Conversion Docs","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}