Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance.
Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set confirm_unchanged to true to spend another test.
Poll Get a placement test until status is no longer running; eta_at gives the expected finish time.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mailercloud API","description":"Send campaigns, manage contacts, and automate email with the Mailercloud API.","colors":{"primary":"#1B7CFF","light":"#4D9AFF","dark":"#0F62D8"},"logo":{"light":"https://mintcdn.com/mailercloud/i1yaE0mG2KZobCyB/logo/light.svg?fit=max\u0026auto=format\u0026n=i1yaE0mG2KZobCyB\u0026q=85\u0026s=ee63a470243c3c865ec9248b577f2a20","dark":"https://mintcdn.com/mailercloud/141gVSRGKgQdCHEd/logo/dark.svg?fit=max\u0026auto=format\u0026n=141gVSRGKgQdCHEd\u0026q=85\u0026s=cc781b737536e3755238b1d9eaf979c3","href":"https://www.mailercloud.com"},"favicon":"https://mintcdn.com/mailercloud/i1yaE0mG2KZobCyB/favicon.png?fit=max\u0026auto=format\u0026n=i1yaE0mG2KZobCyB\u0026q=85\u0026s=00200874c6abcc324677e5a8fb5505c0","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","python","javascript","php","go"]}},"background":{"color":{"dark":"#0A1220"}},"navbar":{"links":[{"href":"https://app.mailercloud.com/login","label":"Sign In"}],"primary":{"type":"button","label":"Get Started","href":"https://app.mailercloud.com/register?source=apidoc"}},"footer":{"socials":{"website":"https://www.mailercloud.com","x":"https://twitter.com/mailercloud","linkedin":"https://www.linkedin.com/company/mailercloud","facebook":"https://www.facebook.com/mailercloud","youtube":"https://www.youtube.com/channel/UCslSwv-TECN8rLvFM8wRlog"}},"fonts":{"heading":{"family":"Hanken Grotesk","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mailercloud","hasAudioNarration":false,"actualSubdomain":"mailercloud","customDomains":["apidoc.mailercloud.com"],"gitSource":{"type":"github","owner":"mailercloud-com","repo":"mailercloud-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae091e9cdcf99f97c311857","collectionId":"775cbcda-5fd4-4c29-a3b1-7e28eef12609","liveDeploymentHistoryId":"6ae091e9cdcf99f97c311857","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae091e9cdcf99f97c311857","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Marketing API","count":71},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Campaigns","count":12},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Contacts","count":8},{"language":"default","tag":"Domains","count":7},{"language":"default","tag":"Inbox Tracker","count":7},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Email API","count":6},{"language":"default","tag":"Email","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@mailercloud.com"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#content-area .prose.text-lg{font-size:1rem;line-height:1.7}#pagination .pagination-title{font-size:.875rem;line-height:1.45}#navbar,#navbar-transition{background:linear-gradient(90deg,#0f62d8 0,#1b7cff 65%,#3d8bff 100%)!important;border-bottom:none!important;backdrop-filter:none!important}#navbar a,#navbar button,#navbar p,#navbar span,#navbar svg{color:#fff}#navbar a:hover{opacity:.85}#navbar img[src*=\"logo/light\"]{display:none!important}#navbar img[src*=\"logo/dark\"]{display:block!important}#topbar-cta-button a>span.absolute{background:#fff!important}#assistant-entry,#assistant-entry *,#topbar-cta-button,#topbar-cta-button *{color:#0f62d8!important}#search-bar-entry{background:rgba(255,255,255,.15);border-color:rgba(255,255,255,.3)}.dark #navbar,.dark #navbar-transition{background:linear-gradient(90deg,#0b2a55 0,#10408a 65%,#164fa5 100%)!important}.dark #assistant-entry,.dark #assistant-entry *{color:#7eb3ff!important}.dark #topbar-cta-button,.dark #topbar-cta-button *{color:#0f62d8!important}.tryit-button{background:#1b7cff!important;color:#fff!important}.tryit-button:hover{background:#0f62d8!important;opacity:1!important}#content-area h1{font-size:1.9375rem}#content-area h2{font-size:1.5625rem}#content-area h3{font-size:1.25rem}"}],"page":{"pagePath":"api-reference/inbox-tracker/start-a-placement-test","slug":"/api-reference/inbox-tracker/start-a-placement-test","pageMetadata":{"title":"Start a placement test","description":"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance.\n\nOnly draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set `confirm_unchanged` to `true` to spend another test.\n\nPoll Get a placement test until `status` is no longer `running`; `eta_at` gives the expected finish time.","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /v2/placement/tests","href":"/api-reference/inbox-tracker/start-a-placement-test","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, 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(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set \", _jsx(_components.code, {\n children: \"confirm_unchanged\"\n }), \" to \", _jsx(_components.code, {\n children: \"true\"\n }), \" to spend another test.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Poll Get a placement test until \", _jsx(_components.code, {\n children: \"status\"\n }), \" is no longer \", _jsx(_components.code, {\n children: \"running\"\n }), \"; \", _jsx(_components.code, {\n children: \"eta_at\"\n }), \" gives the expected finish time.\"]\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":"Start a placement test","description":"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance.\n\nOnly draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set `confirm_unchanged` to `true` to spend another test.\n\nPoll Get a placement test until `status` is no longer `running`; `eta_at` gives the expected finish time.","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /v2/placement/tests","href":"/api-reference/inbox-tracker/start-a-placement-test","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Start a placement test","operationId":"placement-start-test","description":"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance.\n\nOnly draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set `confirm_unchanged` to `true` to spend another test.\n\nPoll Get a placement test until `status` is no longer `running`; `eta_at` gives the expected finish time.","tags":["Inbox Tracker"],"servers":["a245f648-da08-43a3-8c92-1c2db7122a03"],"parameters":["b5b9f5e1-278b-496a-baca-922e3d5f42b4"],"requestBody":"5a176703-895b-4718-acba-491af5ad64e0","responses":{"201":"113026e6-cb7e-42fe-bf25-810986abd6e1","400":"21f4bfaa-32f4-413b-90ea-2d21d4b0270a","401":"73f6dad4-5387-4fb1-856f-7b9ce4972590","403":"2f935a36-cd4d-42e5-a2d6-1b4b4125ce49","404":"7818d3be-61ca-4f11-936f-cfb8cfdb0bae","409":"8db4f640-6280-437c-ba8c-322f76b95cdd","503":"17114196-9f62-47e5-be95-fad02a60b7c4"},"method":"post","type":"path","security":["797e1cf7-8b79-49d7-8256-e509d254deea"],"path":"/v2/placement/tests","baseUrlOptions":["https://cloudapi.mailercloud.com"],"title":"Start a placement test","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b5b9f5e1-278b-496a-baca-922e3d5f42b4":{"name":"Content-Type","in":"header","required":true,"description":"Request body type","schema":{"type":"string","default":"application/json","isRequired":true,"description":"Request body type","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["campaign_id","provider_ids"],"properties":{"campaign_id":{"type":"string","description":"Draft campaign id, as returned by the Campaigns API.","isRequired":true,"uniqueKey":"campaign_id","typeLabel":"string"},"provider_ids":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","uniqueKey":"provider_ids.items.[INDEX]","typeLabel":"string"},"description":"Provider ids from List placement providers.","isRequired":true,"uniqueKey":"provider_ids","typeLabel":"string[]"},"confirm_unchanged":{"type":"boolean","default":false,"description":"Run again even though the draft has not changed since its last test.","uniqueKey":"confirm_unchanged","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example-1":{"title":"Example-1","value":{"campaign_id":"Hws","provider_ids":["1","2"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"113026e6-cb7e-42fe-bf25-810986abd6e1":{"description":"Test started.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"test_id":{"type":"string","uniqueKey":"data.test_id","typeLabel":"string"},"status":{"type":"string","enum":["running"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"started_at":{"type":"string","format":"date-time","uniqueKey":"data.started_at","typeLabel":"string\u003cdate-time>"},"seeds_total":{"type":"integer","uniqueKey":"data.seeds_total","typeLabel":"integer"},"tests_left":{"type":"integer","description":"Tests left in the current period after this one.","uniqueKey":"data.tests_left","typeLabel":"integer"},"eta_at":{"oneOf":[{"type":"string","format":"date-time","description":"Estimated finish time while the test is running; `null` otherwise.","uniqueKey":"data.eta_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Estimated finish time while the test is running; `null` otherwise.","uniqueKey":"data.eta_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.eta_at","typeLabel":"string\u003cdate-time> | null"},"eta_seconds":{"oneOf":[{"type":"integer","description":"Estimated seconds from start to finish while running; `null` otherwise.","uniqueKey":"data.eta_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Estimated seconds from start to finish while running; `null` otherwise.","uniqueKey":"data.eta_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.eta_seconds","typeLabel":"integer | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"test_id":"\u003cstring>","status":"running","started_at":"2023-11-07T05:31:56Z","seeds_total":123,"tests_left":123,"eta_at":"2023-11-07T05:31:56Z","eta_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"21f4bfaa-32f4-413b-90ea-2d21d4b0270a":{"description":"Invalid body, or `provider_ids` empty, over 100 or unknown.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable message.","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["INVALID_INPUT"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"INVALID_INPUT"}}},"exampleType":"generated"}},"exampleType":"generated"},"73f6dad4-5387-4fb1-856f-7b9ce4972590":{"description":"Missing or invalid API key.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2f935a36-cd4d-42e5-a2d6-1b4b4125ce49":{"description":"The account has no active Advanced Inbox Tracker add-on on a paid plan.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable message.","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["ADDON_INACTIVE"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"ADDON_INACTIVE"}}},"exampleType":"generated"}},"exampleType":"generated"},"7818d3be-61ca-4f11-936f-cfb8cfdb0bae":{"description":"Campaign not found for this account.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable message.","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["CAMPAIGN_NOT_FOUND"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"CAMPAIGN_NOT_FOUND"}}},"exampleType":"generated"}},"exampleType":"generated"},"8db4f640-6280-437c-ba8c-322f76b95cdd":{"description":"The test cannot start: the campaign is not a draft regular campaign, the draft is incomplete, no tests are left, a test is already running, or the draft is unchanged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable message.","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["CAMPAIGN_TYPE_UNSUPPORTED","DRAFT_NOT_READY","QUOTA_EXHAUSTED","TEST_ALREADY_RUNNING","DRAFT_UNCHANGED"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"resets_on":{"type":"string","description":"With `QUOTA_EXHAUSTED`: when the allowance resets.","uniqueKey":"resets_on","typeLabel":"string"},"test_id":{"type":"string","description":"With `TEST_ALREADY_RUNNING`: the running test.","uniqueKey":"test_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"CAMPAIGN_TYPE_UNSUPPORTED","resets_on":"\u003cstring>","test_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"17114196-9f62-47e5-be95-fad02a60b7c4":{"description":"Placement testing is not available right now. Nothing was charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable message.","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["PLACEMENT_UNAVAILABLE"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"PLACEMENT_UNAVAILABLE"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"797e1cf7-8b79-49d7-8256-e509d254deea":{"apiKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.","scopes":[],"schemeName":"apiKey"}}},"servers":{"a245f648-da08-43a3-8c92-1c2db7122a03":{"url":"https://cloudapi.mailercloud.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Authorization","type":"string","description":"Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi-v1.json"},"subdomain":"mailercloud","siteName":"Mailercloud API","title":"Start a placement test - Mailercloud API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T11:58:41.600Z","originalFileLocation":"api-reference/inbox-tracker/start-a-placement-test.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=\"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance. Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set confirm_unchanged to true to spend another test. Poll Get a placement test until status is no longer running; eta_at gives the expected finish time.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mailercloud API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_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/mailercloud/xGtgtsD6i5MXTEn-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start a placement test - Mailercloud API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance. Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set confirm_unchanged to true to spend another test. Poll Get a placement test until status is no longer running; eta_at gives the expected finish time.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mailercloud API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mailercloud.mintlify.app/_mintlify/api/og/v2?division=Inbox+Tracker\u0026amp;title=Start+a+placement+test\u0026amp;description=Sends+a+draft+campaign+to+seed+mailboxes+at+the+chosen+providers+and+reports+where+it+lands+%28inbox%2C+Gmail+tabs%2C+spam%2C+missing%29.+Each+test+uses+one+test+from+you\u0026amp;theme=936b6c78a22bbcb175702a1d\u0026amp;signature=fb1848753fe93a3b53322000b04f7d17663c36cb57fbae2c8b940458d7eebeb2\">\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=\"Start a placement test - Mailercloud API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance. Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set confirm_unchanged to true to spend another test. Poll Get a placement test until status is no longer running; eta_at gives the expected finish time.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mailercloud.mintlify.app/_mintlify/api/og/v2?division=Inbox+Tracker\u0026amp;title=Start+a+placement+test\u0026amp;description=Sends+a+draft+campaign+to+seed+mailboxes+at+the+chosen+providers+and+reports+where+it+lands+%28inbox%2C+Gmail+tabs%2C+spam%2C+missing%29.+Each+test+uses+one+test+from+you\u0026amp;theme=936b6c78a22bbcb175702a1d\u0026amp;signature=fb1848753fe93a3b53322000b04f7d17663c36cb57fbae2c8b940458d7eebeb2\">\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/mailercloud/xGtgtsD6i5MXTEn-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mailercloud API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1B7CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/inbox-tracker/start-a-placement-test.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://apidoc.mailercloud.com/#organization\",\"name\":\"Mailercloud API\",\"url\":\"https://apidoc.mailercloud.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mailercloud/i1yaE0mG2KZobCyB/logo/light.svg?fit=max\u0026auto=format\u0026n=i1yaE0mG2KZobCyB\u0026q=85\u0026s=ee63a470243c3c865ec9248b577f2a20\"}},{\"@type\":\"WebSite\",\"@id\":\"https://apidoc.mailercloud.com#website\",\"name\":\"Mailercloud API\",\"url\":\"https://apidoc.mailercloud.com\",\"publisher\":{\"@id\":\"https://apidoc.mailercloud.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test#webpage\",\"url\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test\",\"name\":\"Start a placement test\",\"description\":\"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance. Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set confirm_unchanged to true to spend another test. Poll Get a placement test until status is no longer running; eta_at gives the expected finish time.\",\"dateModified\":\"2026-10-27T11:58:41.600Z\",\"isPartOf\":{\"@id\":\"https://apidoc.mailercloud.com#website\"},\"breadcrumb\":{\"@id\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inbox Tracker\",\"item\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/inbox-tracking\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start a placement test\",\"item\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test#apireference\",\"headline\":\"Start a placement test\",\"name\":\"Start a placement test\",\"description\":\"Sends a draft campaign to seed mailboxes at the chosen providers and reports where it lands (inbox, Gmail tabs, spam, missing). Each test uses one test from your Advanced Inbox Tracker allowance. Only draft regular campaigns with a subject, sender and content can be tested. Only one test can run per campaign at a time. If the draft has not changed since its last test, set confirm_unchanged to true to spend another test. Poll Get a placement test until status is no longer running; eta_at gives the expected finish time.\",\"url\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test\",\"mainEntityOfPage\":{\"@id\":\"https://apidoc.mailercloud.com/api-reference/inbox-tracker/start-a-placement-test#webpage\"},\"dateModified\":\"2026-10-27T11:58:41.600Z\",\"publisher\":{\"@id\":\"https://apidoc.mailercloud.com/#organization\"},\"isPartOf\":{\"@id\":\"https://apidoc.mailercloud.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mailercloud API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Mailercloud API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Marketing API","icon":"envelopes-bulk","groups":[{"group":"Campaigns","pages":[{"title":"Create Campaign","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign","href":"/api-reference/campaigns/create-campaign"},{"title":"Create Campaign (v2)","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/save","href":"/api-reference/campaigns/create-campaign-v2"},{"title":"Campaign Domain Report","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/domain/report/{id}","href":"/api-reference/campaigns/campaign-domain-report"},{"title":"Campaign List","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/list","href":"/api-reference/campaigns/campaign-list"},{"title":"Testmail Group List","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/testmail-groups/list","href":"/api-reference/campaigns/testmail-group-list"},{"title":"Schedule Campaign","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/schedule/{id}","href":"/api-reference/campaigns/schedule-campaign"},{"title":"Send a Test Email","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/testmail/{id}","href":"/api-reference/campaigns/send-a-test-email"},{"title":"Get Single Campaign Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /campaign/{id}","href":"/api-reference/campaigns/get-single-campaign-details"},{"title":"Update Campaign","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /campaign/{id}","href":"/api-reference/campaigns/update-campaign"},{"title":"List Campaign Opens","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/{id}/opens","href":"/api-reference/campaigns/list-campaign-opens"},{"title":"List Campaign Clicks","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/{id}/clicks","href":"/api-reference/campaigns/list-campaign-clicks"},{"title":"List Campaign Unsubscribes","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /campaign/{id}/unsubs","href":"/api-reference/campaigns/list-campaign-unsubscribes"}]},{"group":"Custom Properties","pages":[{"title":"Create Property","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contact/property","href":"/api-reference/custom-properties/create-property"},{"title":"Delete Property","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /contact/property/{id}","href":"/api-reference/custom-properties/delete-property"},{"title":"Update Property","deprecated":null,"version":null,"openapi":"/openapi-v1.json patch /contact/property/{id}","href":"/api-reference/custom-properties/update-property"},{"title":"List Property","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contact/property/search","href":"/api-reference/custom-properties/list-property"}]},{"group":"Contacts","pages":[{"title":"Create Contact","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contacts","href":"/api-reference/contacts/create-contact"},{"title":"Create or Update Contact","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contacts/upsert","href":"/api-reference/contacts/create-or-update-contact"},{"title":"Get Contact Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /contacts/{id}","href":"/api-reference/contacts/get-contact-details"},{"title":"Update Contact","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /contacts/{id}","href":"/api-reference/contacts/update-contact"},{"title":"Delete Contact","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /contacts/{id}","href":"/api-reference/contacts/delete-contact"},{"title":"Remove Contact Tag","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contact/tag/remove","href":"/api-reference/contacts/remove-contact-tag"},{"title":"Get Contacts in a List","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contact/search/{id}","href":"/api-reference/contacts/get-contacts-in-a-list"},{"title":"Create Batch Contact","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /contacts/batch","href":"/api-reference/contacts/create-batch-contact"}]},{"group":"Lists","pages":[{"title":"Create a New List","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /list","href":"/api-reference/lists/create-a-new-list"},{"title":"Get Single List Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /list/{id}","href":"/api-reference/lists/get-single-list-details"},{"title":"Delete a List","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /list/{id}","href":"/api-reference/lists/delete-a-list"},{"title":"Update a List","deprecated":null,"version":null,"openapi":"/openapi-v1.json patch /list/{id}","href":"/api-reference/lists/update-a-list"},{"title":"List Lists","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /lists/search","href":"/api-reference/lists/list-lists"}]},{"group":"Segments","pages":[{"title":"List Segment","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /segment/search","href":"/api-reference/segments/list-segment"},{"title":"Create Segment","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /segments","href":"/api-reference/segments/create-segment"},{"title":"Update a Segment","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /segments/{id}","href":"/api-reference/segments/update-a-segment"}]},{"group":"Senders","pages":[{"title":"List Senders","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /senders/search","href":"/api-reference/senders/list-senders"},{"title":"List Reply Emails","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /reply-emails/search","href":"/api-reference/senders/list-reply-emails"},{"title":"Add a Sender","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /senders","href":"/api-reference/senders/add-a-sender"},{"title":"Delete a Sender","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /senders/{id}","href":"/api-reference/senders/delete-a-sender"}]},{"group":"Account","pages":[{"title":"Client Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /client/plan","href":"/api-reference/account/client-details"}]},{"group":"Webforms","pages":[{"title":"Webform List","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /webform/search","href":"/api-reference/webforms/webform-list"}]},{"group":"Tags","pages":[{"title":"Create Tag","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /tags","href":"/api-reference/tags/create-tag"},{"title":"List Tags","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /tags/search","href":"/api-reference/tags/list-tags"},{"title":"Update Tag","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /tags/{id}","href":"/api-reference/tags/update-tag"},{"title":"Delete Tag","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /tags/{id}","href":"/api-reference/tags/delete-tag"}]},{"group":"Webhooks","pages":[{"title":"Create a New Webhook","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /webhooks","href":"/api-reference/webhooks/create-a-new-webhook"},{"title":"Update a Webhook","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a Webhook","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Get Webhook Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /webhooks/detail/{id}","href":"/api-reference/webhooks/get-webhook-details"},{"title":"Search and List Webhooks","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /webhooks/search","href":"/api-reference/webhooks/search-and-list-webhooks"},{"title":"Test Webhook","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /webhooks/test","href":"/api-reference/webhooks/test-webhook"},{"title":"Toggle Webhook Status","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /webhooks/toggle/{id}","href":"/api-reference/webhooks/toggle-webhook-status"}]},{"group":"Templates","pages":[{"title":"Create Template","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /templates/create","href":"/api-reference/templates/create-template"},{"title":"Update Template","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /templates/update","href":"/api-reference/templates/update-template"},{"title":"Get Template Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /templates/details/{id}","href":"/api-reference/templates/get-template-details"},{"title":"List Templates","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /templates/list","href":"/api-reference/templates/list-templates"},{"title":"Get Template Categories","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /templates/categories/list","href":"/api-reference/templates/get-template-categories"},{"title":"Get Template by Name or ID","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /templates/details","href":"/api-reference/templates/get-template-by-name-or-id"}]},{"group":"Automations","pages":[{"title":"Get Automation Details","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /automations/{id}","href":"/api-reference/automations/get-automation-details"},{"title":"Create Automation","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /automations","href":"/api-reference/automations/create-automation"}]},{"group":"Domains","pages":[{"title":"Add a Domain","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /domains","href":"/api-reference/domains/add-a-domain"},{"title":"List Domains","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /domains/search","href":"/api-reference/domains/list-domains"},{"title":"Get a Domain","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /domains/{id}","href":"/api-reference/domains/get-a-domain"},{"title":"Update a Domain","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /domains/{id}","href":"/api-reference/domains/update-a-domain"},{"title":"Delete a Domain","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /domains/{id}","href":"/api-reference/domains/delete-a-domain"},{"title":"Verify a Domain","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /domains/{id}/verify","href":"/api-reference/domains/verify-a-domain"},{"title":"Share DNS Records","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /domains/{id}/share","href":"/api-reference/domains/share-dns-records"}]},{"group":"Inbox Tracker","pages":[{"title":"Inbox-tracking","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /inbox-tracking","href":"/api-reference/inbox-tracker/inbox-tracking"},{"title":"List placement providers","description":"Mailbox providers you can pick for a placement test, grouped by region and market. Use the provider `id` values in `provider_ids` when you start a test. Spam-filter checks are added to every test automatically and are not listed.","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /v2/placement/providers","href":"/api-reference/inbox-tracker/list-placement-providers"},{"title":"Start a placement test","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /v2/placement/tests","href":"/api-reference/inbox-tracker/start-a-placement-test"},{"title":"Get a placement test","description":"Full result of one placement test: placement per provider and market, Gmail tabs, authentication, spam-filter verdicts, blocklists, content checks and a list of issues with fixes. While `status` is `running`, the numbers fill in as seeds report.","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /v2/placement/tests/{test_id}","href":"/api-reference/inbox-tracker/get-a-placement-test"},{"title":"Get a campaign's latest placement test","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /v2/placement/campaigns/{campaign_id}/latest","href":"/api-reference/inbox-tracker/get-a-campaigns-latest-placement-test"},{"title":"List a campaign's placement tests","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /v2/placement/campaigns/{campaign_id}/tests","href":"/api-reference/inbox-tracker/list-a-campaigns-placement-tests"},{"title":"Get placement test quota","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /v2/placement/quota","href":"/api-reference/inbox-tracker/get-placement-test-quota"}]}]},{"tab":"Email API","icon":"paper-plane","pages":[{"title":"Email API","href":"/api-reference/email/send-email"}]},{"tab":"Email Verifier","icon":"circle-check","pages":[{"title":"Email Verifier","href":"/api-reference/verification/verify-emails"}]}]},"title":"Start a placement test - Mailercloud API","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}