Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.
Workspace-scoped token sent in the Authorization header as Bearer . Access depends on the credential's allowed operations, read or write scope, and workspace subscription. Use an API key issued in the tracker for Public API v1. MCP uses separate OAuth credentials.
Body
application/json
Omitted cost uses none. Omitted tracking uses redirect and domainId null. Use a rotator set to Global or the campaign country.
An active rotator in this workspace with an enabled default path. Redirect paths need an enabled offer with positive weight. Hosted landings on enabled redirect paths must be published.
Supported ISO 3166-1 alpha-2 country code, case-insensitive and trimmed. ZZ, Global, and an empty string normalize to ZZ (Global). This controls asset compatibility, not visitor filtering.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Metricanic","description":"Set up campaign tracking, record conversions, understand reports, and connect Metricanic to your tools.","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/metricanic/QbMb888VZ-0go6oG/images/logo-light.svg?fit=max\u0026auto=format\u0026n=QbMb888VZ-0go6oG\u0026q=85\u0026s=0cda5bae5c302d0ea84db380a2b9a394","dark":"https://mintcdn.com/metricanic/QbMb888VZ-0go6oG/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=QbMb888VZ-0go6oG\u0026q=85\u0026s=072464f4dc7ad22caaaec6539b5e13ff","href":"/"},"favicon":"https://mintcdn.com/metricanic/QbMb888VZ-0go6oG/images/favicon.svg?fit=max\u0026auto=format\u0026n=QbMb888VZ-0go6oG\u0026q=85\u0026s=39bda87c96d9ef28fc242136ce9a4ee5","api":{"openapi":"openapi.public.yaml","playground":{"display":"simple"}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://metricanic.com","label":"Website"}],"primary":{"type":"button","label":"Open tracker","href":"https://panel.metricanic.com"}},"seo":{"metatags":{"canonical":"https://docs.metricanic.com"}},"contextual":{"options":[{"title":"Figure it out with ChatGPT","description":"Ask questions, get examples, and learn step by step.","icon":{"style":"brands","name":"openai"},"href":{"base":"https://chat.openai.com/","query":[{"key":"hints","value":"search"},{"key":"q","value":"Help me understand and use Metricanic.\n\nRead this guide: https://docs.metricanic.com$path\nUse https://docs.metricanic.com/llms.txt to find related guides when needed.\n\nBase your answers on the documentation. Explain things simply, with practical steps and examples. If something is not covered, say so.\n\nFor now, don't summarize the guide or explain the setup. After reading it, simply say:\n\"I've read the guide and I'm ready to help. What would you like to figure out?\"\n\nIf you cannot access the guide, ask me to paste it using Copy page.\n\nReply in my preferred language."}]}},{"title":"Figure it out with Claude","description":"Ask questions, get examples, and learn step by step.","icon":{"style":"brands","name":"claude"},"href":{"base":"https://claude.ai/new","query":[{"key":"q","value":"Help me understand and use Metricanic.\n\nRead this guide: https://docs.metricanic.com$path\nUse https://docs.metricanic.com/llms.txt to find related guides when needed.\n\nBase your answers on the documentation. Explain things simply, with practical steps and examples. If something is not covered, say so.\n\nFor now, don't summarize the guide or explain the setup. After reading it, simply say:\n\"I've read the guide and I'm ready to help. What would you like to figure out?\"\n\nIf you cannot access the guide, ask me to paste it using Copy page.\n\nReply in my preferred language."}]}},"copy","view","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"metricanic","hasAudioNarration":false,"actualSubdomain":"metricanic","customDomains":["docs.metricanic.com"],"gitSource":{"type":"github","owner":"bushwellco","repo":"metricanic-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aecb95a443c20b826a647ba","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API reference","count":53},{"language":"default","tag":"Endpoints","count":48},{"language":"default","tag":"Guides","count":40},{"language":"default","tag":"Rotators","count":9},{"language":"default","tag":"Campaigns","count":8},{"language":"default","tag":"Reports and optimization","count":8},{"language":"default","tag":"Campaigns and tracking","count":8},{"language":"default","tag":"Affiliate Networks","count":7},{"language":"default","tag":"Landings","count":7},{"language":"default","tag":"Offers","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]"}},"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":"llms-txt-v2","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}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoints/create-campaign","slug":"/api-reference/endpoints/create-campaign","pageMetadata":{"title":"Create campaign","openapi":"openapi.public.yaml POST /api/v1/campaigns","description":"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.","href":"/api-reference/endpoints/create-campaign"},"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: \"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.\"\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":"Create campaign","openapi":"openapi.public.yaml POST /api/v1/campaigns","description":"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.","href":"/api-reference/endpoints/create-campaign"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/metricanic/10404a4d662ca2d3/legacy-api-anchors.js"],"openApiReferenceData":{"operation":{"summary":"Create campaign","description":"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.","requestBody":"f3969cf7-e904-45f5-9a10-90796ed40545","responses":{"201":"1e62c5e3-0060-4cee-acc8-da8027e0bab3","400":"fb0e5414-a94e-4519-b49c-d62581e2e079","401":"ff51abc0-4bee-4199-b2b1-2efb1aeef95d","403":"c2084dca-939c-4a7d-b627-1aaf320f97b5","404":"4743964d-2bd8-4fb3-a1ff-fe9de1101aa4","409":"538fee75-77db-4699-bd3a-df078fb9a2d4","413":"4cc63d8d-c586-4e7a-b08a-f391cdfeb3d3","422":"c2a2c0ad-b161-4548-8f0f-4c4d7b2981f8","429":"1e1604ac-8ce1-4bb4-8d00-c9a2fe7397b9","503":"3a7463e2-35ce-44ba-bc6d-17408362dfb2","default":"045efa79-9d91-4a52-bfc7-af74e42d6fe7"},"operationId":"createCampaign","tags":["Campaigns"],"method":"post","type":"path","servers":["ed9a9508-e599-4334-b20b-89f9a4a8c52b"],"security":["2c522a7c-b75d-4bee-ac08-b940141da758"],"path":"/api/v1/campaigns","baseUrlOptions":["https://panel.metricanic.com"],"title":"Create campaign","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"us-search-mainstream","trafficSourceId":"6f9d2b4e-8a1c-4d3e-9f5a-7b2c4d6e8f0a","country":"US","cost":{"mode":"cpv","amount":0.012},"tracking":{"method":"redirect"},"destination":{"mode":"use_rotator","rotatorId":"9b8c7d6e-5f4a-4b3c-8d1e-0f9a8b7c6d5e"}},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"trafficSourceId":{"type":"string","isRequired":true,"uniqueKey":"trafficSourceId","typeLabel":"string"},"destination":{"type":"object","description":"An active rotator in this workspace with an enabled default path. Redirect paths need an enabled offer with positive weight. Hosted landings on enabled redirect paths must be published.","properties":{"mode":{"type":"string","enum":["use_rotator"],"isRequired":true,"uniqueKey":"destination.mode","typeLabel":"enum\u003cstring>"},"rotatorId":{"type":"string","isRequired":true,"uniqueKey":"destination.rotatorId","typeLabel":"string"}},"required":["mode","rotatorId"],"additionalProperties":false,"isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"country":{"type":"string","description":"Supported ISO 3166-1 alpha-2 country code, case-insensitive and trimmed. ZZ, Global, and an empty string normalize to ZZ (Global). This controls asset compatibility, not visitor filtering.","default":"ZZ","uniqueKey":"country","typeLabel":"string"},"cost":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"cost.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"cost.oneOf.0","typeLabel":"object"},{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["auto"],"isRequired":true,"uniqueKey":"cost.oneOf.1.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"cost.oneOf.1","typeLabel":"object"},{"type":"object","required":["mode","amount"],"properties":{"mode":{"type":"string","enum":["cpv"],"isRequired":true,"uniqueKey":"cost.oneOf.2.mode","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"cost.oneOf.2.amount","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"cost.oneOf.2","typeLabel":"object"}],"uniqueKey":"cost","typeLabel":"object"},"tracking":{"type":"object","properties":{"method":{"type":"string","enum":["redirect","direct"],"isRequired":true,"uniqueKey":"tracking.method","typeLabel":"enum\u003cstring>"},"domainId":{"oneOf":[{"type":"string","description":"Active tracking domain in your workspace. Null or blank uses no custom domain.","uniqueKey":"tracking.domainId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Active tracking domain in your workspace. Null or blank uses no custom domain.","uniqueKey":"tracking.domainId.oneOf.1","typeLabel":"null"}],"uniqueKey":"tracking.domainId","typeLabel":"string | null"}},"required":["method"],"additionalProperties":false,"uniqueKey":"tracking","typeLabel":"object"}},"required":["name","trafficSourceId","destination"],"additionalProperties":false,"description":"Omitted cost uses none. Omitted tracking uses redirect and domainId null. Use a rotator set to Global or the campaign country.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"us-search-mainstream","trafficSourceId":"6f9d2b4e-8a1c-4d3e-9f5a-7b2c4d6e8f0a","country":"US","cost":{"mode":"cpv","amount":0.012},"tracking":{"method":"redirect"},"destination":{"mode":"use_rotator","rotatorId":"9b8c7d6e-5f4a-4b3c-8d1e-0f9a8b7c6d5e"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"1e62c5e3-0060-4cee-acc8-da8027e0bab3":{"description":"Campaign created","content":{"application/json":{"example":{"ok":true,"data":{"campaign":{"id":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","name":"us-search-mainstream","displayName":"us-search-mainstream","status":"active","trafficSourceId":"6f9d2b4e-8a1c-4d3e-9f5a-7b2c4d6e8f0a","country":"US","cost":{"mode":"cpv","amount":0.012},"tracking":{"method":"redirect","domainId":null},"destination":{"type":"rotator","rotatorId":"9b8c7d6e-5f4a-4b3c-8d1e-0f9a8b7c6d5e"},"createdAt":"2026-05-15T09:30:00.000Z"},"publish":{"status":"queued"}}},"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"data":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.campaign.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.campaign.name","typeLabel":"string"},"displayName":{"type":"string","isRequired":true,"uniqueKey":"data.campaign.displayName","typeLabel":"string"},"status":{"type":"string","enum":["active","archived","paused"],"isRequired":true,"uniqueKey":"data.campaign.status","typeLabel":"enum\u003cstring>"},"trafficSourceId":{"type":"string","isRequired":true,"uniqueKey":"data.campaign.trafficSourceId","typeLabel":"string"},"country":{"type":"string","isRequired":true,"uniqueKey":"data.campaign.country","typeLabel":"string"},"cost":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.0","typeLabel":"object"},{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["auto"],"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.1.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.1","typeLabel":"object"},{"type":"object","required":["mode","amount"],"properties":{"mode":{"type":"string","enum":["cpv"],"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.2.mode","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.2.amount","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.campaign.cost.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.campaign.cost","typeLabel":"object"},"tracking":{"type":"object","properties":{"method":{"type":"string","enum":["redirect","direct"],"isRequired":true,"uniqueKey":"data.campaign.tracking.method","typeLabel":"enum\u003cstring>"},"domainId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.campaign.tracking.domainId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.campaign.tracking.domainId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.campaign.tracking.domainId","typeLabel":"string | null"}},"required":["method","domainId"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.campaign.tracking","typeLabel":"object"},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["rotator"],"isRequired":true,"uniqueKey":"data.campaign.destination.type","typeLabel":"enum\u003cstring>"},"rotatorId":{"type":"string","isRequired":true,"uniqueKey":"data.campaign.destination.rotatorId","typeLabel":"string"}},"required":["type","rotatorId"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.campaign.destination","typeLabel":"object"},"createdAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.campaign.createdAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.campaign.createdAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.campaign.createdAt","typeLabel":"string | null"}},"required":["id","name","displayName","status","trafficSourceId","country","cost","tracking","destination","createdAt"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.campaign","typeLabel":"object"},"publish":{"type":"object","properties":{"status":{"type":"string","enum":["published","queued","not_required"],"description":"published means the tracking configuration was published. queued means publication is scheduled. not_required occurs only for a campaign PATCH with no changed fields.","isRequired":true,"uniqueKey":"data.publish.status","typeLabel":"enum\u003cstring>"}},"required":["status"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.publish","typeLabel":"object"}},"required":["campaign","publish"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["ok","data"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"data":{"campaign":{"id":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","name":"us-search-mainstream","displayName":"us-search-mainstream","status":"active","trafficSourceId":"6f9d2b4e-8a1c-4d3e-9f5a-7b2c4d6e8f0a","country":"US","cost":{"mode":"cpv","amount":0.012},"tracking":{"method":"redirect","domainId":null},"destination":{"type":"rotator","rotatorId":"9b8c7d6e-5f4a-4b3c-8d1e-0f9a8b7c6d5e"},"createdAt":"2026-05-15T09:30:00.000Z"},"publish":{"status":"queued"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"fb0e5414-a94e-4519-b49c-d62581e2e079":{"description":"Invalid JSON or invalid entity payload","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ff51abc0-4bee-4199-b2b1-2efb1aeef95d":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c2084dca-939c-4a7d-b627-1aaf320f97b5":{"description":"The authenticated caller is not allowed to perform this operation.","headers":{"WWW-Authenticate":{"description":"Bearer challenge describing the required scopes when access is denied for insufficient scope.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4743964d-2bd8-4fb3-a1ff-fe9de1101aa4":{"description":"Referenced traffic source, rotator, domain, offer, or landing not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"538fee75-77db-4699-bd3a-df078fb9a2d4":{"description":"Referenced resource is unavailable or incompatible. Codes include CAMPAIGN_ROTATOR_UNAVAILABLE and HOSTING_LANDING_UNPUBLISHED.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4cc63d8d-c586-4e7a-b08a-f391cdfeb3d3":{"description":"JSON body exceeds 65536 bytes","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c2a2c0ad-b161-4548-8f0f-4c4d7b2981f8":{"description":"Rotator configuration exceeds the supported limits","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1e1604ac-8ce1-4bb4-8d00-c9a2fe7397b9":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds to wait before retrying when available.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3a7463e2-35ce-44ba-bc6d-17408362dfb2":{"description":"The service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"045efa79-9d91-4a52-bfc7-af74e42d6fe7":{"description":"API error with a message, code and optional details.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"requestId":{"type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["ok","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":{}},"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2c522a7c-b75d-4bee-ac08-b940141da758":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Workspace-scoped token sent in the Authorization header as Bearer \u003ctoken>. Access depends on the credential's allowed operations, read or write scope, and workspace subscription. Use an API key issued in the tracker for Public API v1. MCP uses separate OAuth credentials.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"ed9a9508-e599-4334-b20b-89f9a4a8c52b":{"url":"https://panel.metricanic.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Workspace-scoped token sent in the Authorization header as Bearer \u003ctoken>. Access depends on the credential's allowed operations, read or write scope, and workspace subscription. Use an API key issued in the tracker for Public API v1. MCP uses separate OAuth credentials.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace-scoped token sent in the Authorization header as Bearer \u003ctoken>. Access depends on the credential's allowed operations, read or write scope, and workspace subscription. Use an API key issued in the tracker for Public API v1. MCP uses separate OAuth credentials.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.public.yaml"},"subdomain":"metricanic","siteName":"Metricanic","title":"Create campaign - Metricanic","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-03T09:01:06.626Z","originalFileLocation":"api-reference/endpoints/create-campaign.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=\"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Metricanic\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_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/metricanic/zxRWSLM3xJFHmt_b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create campaign - Metricanic\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Metricanic\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.metricanic.com/api-reference/endpoints/create-campaign\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://metricanic.mintlify.site/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Create+campaign\u0026amp;description=Creates+a+campaign+using+a+saved+rotator+with+destination.mode%3Duse_rotator.+Configure+routing+rules+in+the+campaign+or+rotator+editor.+JSON+request+bodies+are+l\u0026amp;theme=04f32df9d2a71616ee39205d\u0026amp;signature=a5dbd539032061c92e9b03738ea301eb919cc8713c0854e45c92ecd5e79e4a8f\">\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 campaign - Metricanic\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://metricanic.mintlify.site/_mintlify/api/og/v2?division=Campaigns\u0026amp;title=Create+campaign\u0026amp;description=Creates+a+campaign+using+a+saved+rotator+with+destination.mode%3Duse_rotator.+Configure+routing+rules+in+the+campaign+or+rotator+editor.+JSON+request+bodies+are+l\u0026amp;theme=04f32df9d2a71616ee39205d\u0026amp;signature=a5dbd539032061c92e9b03738ea301eb919cc8713c0854e45c92ecd5e79e4a8f\">\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/metricanic/zxRWSLM3xJFHmt_b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Metricanic\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.metricanic.com/api-reference/endpoints/create-campaign\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints/create-campaign.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.metricanic.com/#organization\",\"name\":\"Metricanic\",\"url\":\"https://docs.metricanic.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/metricanic/QbMb888VZ-0go6oG/images/logo-light.svg?fit=max\u0026auto=format\u0026n=QbMb888VZ-0go6oG\u0026q=85\u0026s=0cda5bae5c302d0ea84db380a2b9a394\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.metricanic.com#website\",\"name\":\"Metricanic\",\"url\":\"https://docs.metricanic.com\",\"publisher\":{\"@id\":\"https://docs.metricanic.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign#webpage\",\"url\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign\",\"name\":\"Create campaign\",\"description\":\"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.\",\"dateModified\":\"2026-10-03T09:01:06.626Z\",\"isPartOf\":{\"@id\":\"https://docs.metricanic.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.metricanic.com/api-reference/endpoints/who-am-i\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Campaigns\",\"item\":\"https://docs.metricanic.com/api-reference/endpoints/list-campaigns\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create campaign\",\"item\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign#apireference\",\"headline\":\"Create campaign\",\"name\":\"Create campaign\",\"description\":\"Creates a campaign using a saved rotator with destination.mode=use_rotator. Configure routing rules in the campaign or rotator editor. JSON request bodies are limited to 65536 bytes.\",\"url\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign\",\"mainEntityOfPage\":{\"@id\":\"https://docs.metricanic.com/api-reference/endpoints/create-campaign#webpage\"},\"dateModified\":\"2026-10-03T09:01:06.626Z\",\"publisher\":{\"@id\":\"https://docs.metricanic.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.metricanic.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Metricanic\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Metricanic\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoints/create-campaign.md","siteName":"Metricanic","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Use the API","pages":[{"title":"Start with the API","href":"/api-reference/introduction"},{"title":"Authenticate API requests","href":"/api-reference/authentication"},{"title":"Query reports and inspect events","href":"/api-reference/reports-and-events"},{"title":"Handle API errors","href":"/api-reference/errors"},{"title":"Archive and restore entities","href":"/api-reference/archive-and-restore"}]},{"group":"Endpoints","pages":[{"group":"Authentication","pages":[{"title":"Who am I","openapi":"openapi.public.yaml GET /api/v1/whoami","href":"/api-reference/endpoints/who-am-i"}]},{"group":"Campaigns","pages":[{"title":"List campaigns","openapi":"openapi.public.yaml GET /api/v1/campaigns","description":"Lists campaigns with their tracking settings and destinations.","href":"/api-reference/endpoints/list-campaigns"},{"title":"Create campaign","openapi":"openapi.public.yaml POST /api/v1/campaigns","href":"/api-reference/endpoints/create-campaign"},{"title":"Get campaign","openapi":"openapi.public.yaml GET /api/v1/campaigns/{id}","description":"Returns the campaign and its tracking settings and destination.","href":"/api-reference/endpoints/get-campaign"},{"title":"Update campaign","openapi":"openapi.public.yaml PATCH /api/v1/campaigns/{id}","href":"/api-reference/endpoints/update-campaign"},{"title":"Archive campaign","openapi":"openapi.public.yaml DELETE /api/v1/campaigns/{id}","href":"/api-reference/endpoints/archive-campaign"},{"title":"List goals","openapi":"openapi.public.yaml GET /api/v1/campaigns/{id}/goals","href":"/api-reference/endpoints/list-campaign-goals"},{"title":"Archive campaigns","openapi":"openapi.public.yaml POST /api/v1/campaigns/archive","href":"/api-reference/endpoints/archive-campaigns-bulk"},{"title":"Restore campaigns","openapi":"openapi.public.yaml POST /api/v1/campaigns/restore","href":"/api-reference/endpoints/restore-campaigns-bulk"}]},{"group":"Landings","pages":[{"title":"List landings","openapi":"openapi.public.yaml GET /api/v1/landings","href":"/api-reference/endpoints/list-landings"},{"title":"Create landing","openapi":"openapi.public.yaml POST /api/v1/landings","href":"/api-reference/endpoints/create-landing"},{"title":"Get landing","openapi":"openapi.public.yaml GET /api/v1/landings/{id}","href":"/api-reference/endpoints/get-landing"},{"title":"Update landing","openapi":"openapi.public.yaml PATCH /api/v1/landings/{id}","href":"/api-reference/endpoints/update-landing"},{"title":"Archive landing","openapi":"openapi.public.yaml DELETE /api/v1/landings/{id}","href":"/api-reference/endpoints/delete-landing"},{"title":"Archive landings","openapi":"openapi.public.yaml POST /api/v1/landings/archive","href":"/api-reference/endpoints/archive-landings-bulk"},{"title":"Restore landings","openapi":"openapi.public.yaml POST /api/v1/landings/restore","href":"/api-reference/endpoints/restore-landings-bulk"}]},{"group":"Offers","pages":[{"title":"List offers","openapi":"openapi.public.yaml GET /api/v1/offers","href":"/api-reference/endpoints/list-offers"},{"title":"Create offer","openapi":"openapi.public.yaml POST /api/v1/offers","href":"/api-reference/endpoints/create-offer"},{"title":"Get offer","openapi":"openapi.public.yaml GET /api/v1/offers/{id}","href":"/api-reference/endpoints/get-offer"},{"title":"Update offer","openapi":"openapi.public.yaml PATCH /api/v1/offers/{id}","href":"/api-reference/endpoints/update-offer"},{"title":"Archive offer","openapi":"openapi.public.yaml DELETE /api/v1/offers/{id}","href":"/api-reference/endpoints/delete-offer"},{"title":"Archive offers","openapi":"openapi.public.yaml POST /api/v1/offers/archive","href":"/api-reference/endpoints/archive-offers-bulk"},{"title":"Restore offers","openapi":"openapi.public.yaml POST /api/v1/offers/restore","href":"/api-reference/endpoints/restore-offers-bulk"}]},{"group":"Reports","pages":[{"title":"Query reports","openapi":"openapi.public.yaml GET /api/v1/reports","href":"/api-reference/endpoints/query-reports"}]},{"group":"Rotators","pages":[{"title":"List rotators","openapi":"openapi.public.yaml GET /api/v1/rotators","href":"/api-reference/endpoints/list-rotators"},{"title":"Create rotator","openapi":"openapi.public.yaml POST /api/v1/rotators","href":"/api-reference/endpoints/create-rotator"},{"title":"Get rotator","openapi":"openapi.public.yaml GET /api/v1/rotators/{id}","href":"/api-reference/endpoints/get-rotator"},{"title":"Update rotator","openapi":"openapi.public.yaml PATCH /api/v1/rotators/{id}","href":"/api-reference/endpoints/update-rotator"},{"title":"Archive rotator","openapi":"openapi.public.yaml DELETE /api/v1/rotators/{id}","href":"/api-reference/endpoints/archive-rotator"},{"title":"Get rotator rules","openapi":"openapi.public.yaml GET /api/v1/rotators/{id}/rules","href":"/api-reference/endpoints/get-rotator-rules"},{"title":"List rotator paths","openapi":"openapi.public.yaml GET /api/v1/rotator-paths","href":"/api-reference/endpoints/list-rotator-paths"},{"title":"Archive rotators","openapi":"openapi.public.yaml POST /api/v1/rotators/archive","href":"/api-reference/endpoints/archive-rotators-bulk"},{"title":"Restore rotators","openapi":"openapi.public.yaml POST /api/v1/rotators/restore","href":"/api-reference/endpoints/restore-rotators-bulk"}]},{"group":"Traffic Sources","pages":[{"title":"List traffic sources","openapi":"openapi.public.yaml GET /api/v1/traffic-sources","href":"/api-reference/endpoints/list-traffic-sources"},{"title":"Create traffic source","openapi":"openapi.public.yaml POST /api/v1/traffic-sources","href":"/api-reference/endpoints/create-traffic-source"},{"title":"Get traffic source","openapi":"openapi.public.yaml GET /api/v1/traffic-sources/{id}","href":"/api-reference/endpoints/get-traffic-source"},{"title":"Update traffic source","openapi":"openapi.public.yaml PATCH /api/v1/traffic-sources/{id}","href":"/api-reference/endpoints/update-traffic-source"},{"title":"Archive traffic source","openapi":"openapi.public.yaml DELETE /api/v1/traffic-sources/{id}","href":"/api-reference/endpoints/delete-traffic-source"},{"title":"Archive traffic sources","openapi":"openapi.public.yaml POST /api/v1/traffic-sources/archive","href":"/api-reference/endpoints/archive-traffic-sources-bulk"},{"title":"Restore traffic sources","openapi":"openapi.public.yaml POST /api/v1/traffic-sources/restore","href":"/api-reference/endpoints/restore-traffic-sources-bulk"}]},{"group":"Affiliate Networks","pages":[{"title":"List affiliate networks","openapi":"openapi.public.yaml GET /api/v1/affiliate-networks","href":"/api-reference/endpoints/list-affiliate-networks"},{"title":"Create affiliate network","openapi":"openapi.public.yaml POST /api/v1/affiliate-networks","href":"/api-reference/endpoints/create-affiliate-network"},{"title":"Affiliate network detail","openapi":"openapi.public.yaml GET /api/v1/affiliate-networks/{id}","href":"/api-reference/endpoints/get-affiliate-network"},{"title":"Update affiliate network","openapi":"openapi.public.yaml PATCH /api/v1/affiliate-networks/{id}","href":"/api-reference/endpoints/update-affiliate-network"},{"title":"Archive affiliate network","openapi":"openapi.public.yaml DELETE /api/v1/affiliate-networks/{id}","href":"/api-reference/endpoints/delete-affiliate-network"},{"title":"Archive affiliate networks","openapi":"openapi.public.yaml POST /api/v1/affiliate-networks/archive","href":"/api-reference/endpoints/archive-affiliate-networks-bulk"},{"title":"Restore affiliate networks","openapi":"openapi.public.yaml POST /api/v1/affiliate-networks/restore","href":"/api-reference/endpoints/restore-affiliate-networks-bulk"}]},{"group":"Events","pages":[{"title":"List events","openapi":"openapi.public.yaml GET /api/v1/events","href":"/api-reference/endpoints/list-events"}]}]}]}]},"basePath":"","title":"Create campaign - Metricanic","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}