Pause and resume must not delete the ad or drop historical insights.
Delete is permanent. Targeter uses it when the campaign should not remain in your system.
Get ad status is how Targeter syncs scheduled, active, paused, completed, rejected, and error.
Creatives
material.target_url is always required. Provide at least one of images, videos, or html5 as publicly reachable URLs. Targeter will only request formats listed for each platform in GET /publisher-platforms.
Going live
Stand up the endpoints against a sandbox host.
Send Targeter the sandbox base URL and token.
Targeter runs the typical flow: platforms → office → create ad → status → insights → pause/resume.
Switch the stored base URL and token to production.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Targeter API","colors":{"primary":"#0FB8CB","light":"#0FB8CB"},"logo":{"light":"https://mintcdn.com/fortressdigital/y3e7n_QNhhQaliXE/logo/dark.svg?fit=max\u0026auto=format\u0026n=y3e7n_QNhhQaliXE\u0026q=85\u0026s=9379fe4d811a2442a5085baf1aee6b72","dark":"https://mintcdn.com/fortressdigital/y3e7n_QNhhQaliXE/logo/light.svg?fit=max\u0026auto=format\u0026n=y3e7n_QNhhQaliXE\u0026q=85\u0026s=4b43bf80c38f75a31edf55eadc708dcc"},"favicon":"https://mintcdn.com/fortressdigital/Tz7Vx9E5sAsrP1O8/favicon.ico?fit=max\u0026auto=format\u0026n=Tz7Vx9E5sAsrP1O8\u0026q=85\u0026s=356d45885a2dd11a4baf02ef7f96a2f0","api":{"openapi":["api-reference/openapi.json","integrations/openapi.json"]},"navbar":{"links":[{"href":"mailto:kontakt@targeter.tech","label":"Contact"}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fortressdigital","hasAudioNarration":false,"actualSubdomain":"fortressdigital","customDomains":["docs.targeter.tech"],"gitSource":{"type":"github","owner":"making-code-as","repo":"targeter-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6afaed77d57358ecbcc10fe2"},"entitlements":{},"buildId":"6afaefd4d57358ecbcc14b2d","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"API","count":6},{"language":"default","tag":"Ads","count":6},{"language":"default","tag":"API Reference","count":4},{"language":"default","tag":"Campaigns","count":2},{"language":"default","tag":"Introduction","count":2},{"language":"default","tag":"Getting started","count":2},{"language":"default","tag":"Offices","count":2},{"language":"default","tag":"Insights","count":1},{"language":"default","tag":"Platforms","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"integrations/setup","slug":"/integrations/setup","pageMetadata":{"title":"Setup","description":"What Targeter needs from a publisher before it can call your API","href":"/integrations/setup"},"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: \"What Targeter needs from a publisher before it can call your API\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`what-targeter-needs-from-you`,children:`What Targeter needs from you`}),`\n`,_jsx(_components.p,{children:`Share the following with Targeter integration support before go-live. Targeter stores these as the connection for your platform.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Item`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base URL`}),_jsxs(_components.td,{children:[`API host, including version prefix (for example `,_jsx(_components.code,{children:`https://ads.publisher.no/v1`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Access token`}),_jsx(_components.td,{children:`Bearer token Targeter sends on every request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Token lifetime`}),_jsx(_components.td,{children:`How long the token is valid, and how Targeter should refresh it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Supported functions`}),_jsxs(_components.td,{children:[`Which of the `,_jsx(_components.a,{href:`/integrations/introduction`,children:`ideal functions`}),` you implement`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Platform ids`}),_jsxs(_components.td,{children:[`Stable ids returned by `,_jsx(_components.a,{href:`/integrations/platforms/get`,children:_jsx(_components.code,{children:`GET /publisher-platforms`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Office matching`}),_jsxs(_components.td,{children:[`Whether offices are unique by `,_jsx(_components.code,{children:`name`}),`, and whether Targeter should create missing offices`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Tokens are for server-to-server calls only. Issue a dedicated credential for Targeter; do not reuse a personal or dashboard login.`})}),`\n`,_jsx(Heading,{level:`2`,id:`conventions`,children:`Conventions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`JSON`}),` request and response bodies, `,_jsx(_components.code,{children:`Content-Type: application/json`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`snake_case`}),` field names (`,_jsx(_components.code,{children:`office_id`}),`, `,_jsx(_components.code,{children:`target_url`}),`, `,_jsx(_components.code,{children:`publisher_platforms`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Insight windows`}),` as `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` (inclusive)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Timestamps`}),` as UTC ISO 8601 date-times (`,_jsx(_components.code,{children:`2026-08-20T00:00:00Z`}),`), including `,_jsx(_components.code,{children:`start_date`}),` and `,_jsx(_components.code,{children:`end_date`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IDs`}),` as opaque strings generated by you (`,_jsx(_components.code,{children:`office_id`}),`, `,_jsx(_components.code,{children:`ad_id`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Ids Targeter sends`}),` as opaque strings you store and return unchanged (`,_jsx(_components.code,{children:`campaign_id`}),`)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`office-mapping`,children:`Office mapping`}),`\n`,_jsx(_components.p,{children:`Ads are attributed to an office (brokerage or advertiser account) in your system.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Targeter looks up the office with `,_jsx(_components.a,{href:`/integrations/offices/get`,children:_jsx(_components.code,{children:`GET /offices`})}),` using the name from the Targeter account.`]}),`\n`,_jsxs(_components.li,{children:[`If nothing matches, Targeter calls `,_jsx(_components.a,{href:`/integrations/offices/create`,children:_jsx(_components.code,{children:`POST /offices`})}),`. You generate `,_jsx(_components.code,{children:`office_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Targeter sends that `,_jsx(_components.code,{children:`office_id`}),` on every `,_jsx(_components.a,{href:`/integrations/ads/create`,children:_jsx(_components.code,{children:`POST /ads`})}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Treat `,_jsx(_components.code,{children:`name`}),` as unique. If Targeter creates an office that already exists, return `,_jsx(_components.strong,{children:`200`}),` with the existing `,_jsx(_components.code,{children:`office_id`}),` instead of a duplicate.`]}),`\n`,_jsx(Heading,{level:`2`,id:`ad-lifecycle`,children:`Ad lifecycle`}),`\n`,_jsx(_components.p,{children:`Targeter drives delivery with these status transitions:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`pending_review → scheduled → active ⇄ paused → completed`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↘ rejected`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↘ error`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pause`}),` and `,_jsx(_components.strong,{children:`resume`}),` must not delete the ad or drop historical insights.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delete`}),` is permanent. Targeter uses it when the campaign should not remain in your system.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Get ad status`}),` is how Targeter syncs `,_jsx(_components.code,{children:`scheduled`}),`, `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`paused`}),`, `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`rejected`}),`, and `,_jsx(_components.code,{children:`error`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`creatives`,children:`Creatives`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`material.target_url`}),` is always required. Provide at least one of `,_jsx(_components.code,{children:`images`}),`, `,_jsx(_components.code,{children:`videos`}),`, or `,_jsx(_components.code,{children:`html5`}),` as publicly reachable URLs. Targeter will only request formats listed for each platform in `,_jsx(_components.a,{href:`/integrations/platforms/get`,children:_jsx(_components.code,{children:`GET /publisher-platforms`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`going-live`,children:`Going live`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Stand up the endpoints against a sandbox host.`}),`\n`,_jsx(_components.li,{children:`Send Targeter the sandbox base URL and token.`}),`\n`,_jsxs(_components.li,{children:[`Targeter runs the `,_jsx(_components.a,{href:`/integrations/introduction#typical-flow`,children:`typical flow`}),`: platforms → office → create ad → status → insights → pause/resume.`]}),`\n`,_jsx(_components.li,{children:`Switch the stored base URL and token to production.`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Setup","description":"What Targeter needs from a publisher before it can call your API","href":"/integrations/setup"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What Targeter needs from you","slug":"what-targeter-needs-from-you","depth":2,"children":[]},{"title":"Conventions","slug":"conventions","depth":2,"children":[]},{"title":"Office mapping","slug":"office-mapping","depth":2,"children":[]},{"title":"Ad lifecycle","slug":"ad-lifecycle","depth":2,"children":[]},{"title":"Creatives","slug":"creatives","depth":2,"children":[]},{"title":"Going live","slug":"going-live","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"fortressdigital","siteName":"Targeter API","title":"Setup - Targeter API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T11:48:12.485Z","originalFileLocation":"integrations/setup.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=\"What Targeter needs from a publisher before it can call your API\">\u003cmeta data-mint-head name=\"application-name\" content=\"Targeter 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/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_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/fortressdigital/NbPmLllZZBelb8xk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Setup - Targeter API\">\u003cmeta data-mint-head property=\"og:description\" content=\"What Targeter needs from a publisher before it can call your API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Targeter API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.targeter.tech/integrations/setup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fortressdigital.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Setup\u0026amp;description=What+Targeter+needs+from+a+publisher+before+it+can+call+your+API\u0026amp;theme=db1f30f0c0ee1e7de433f097\u0026amp;signature=27ca21cf31999573acad8ee335886153131f368952d441f707a4bcddbd9480d7\">\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=\"Setup - Targeter API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What Targeter needs from a publisher before it can call your API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fortressdigital.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Setup\u0026amp;description=What+Targeter+needs+from+a+publisher+before+it+can+call+your+API\u0026amp;theme=db1f30f0c0ee1e7de433f097\u0026amp;signature=27ca21cf31999573acad8ee335886153131f368952d441f707a4bcddbd9480d7\">\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/fortressdigital/NbPmLllZZBelb8xk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Targeter API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0FB8CB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.targeter.tech/integrations/setup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/setup.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.targeter.tech/#organization\",\"name\":\"Targeter API\",\"url\":\"https://docs.targeter.tech\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fortressdigital/y3e7n_QNhhQaliXE/logo/dark.svg?fit=max\u0026auto=format\u0026n=y3e7n_QNhhQaliXE\u0026q=85\u0026s=9379fe4d811a2442a5085baf1aee6b72\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.targeter.tech#website\",\"name\":\"Targeter API\",\"url\":\"https://docs.targeter.tech\",\"publisher\":{\"@id\":\"https://docs.targeter.tech/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.targeter.tech/integrations/setup#webpage\",\"url\":\"https://docs.targeter.tech/integrations/setup\",\"name\":\"Setup\",\"description\":\"What Targeter needs from a publisher before it can call your API\",\"dateModified\":\"2026-11-16T11:48:12.485Z\",\"isPartOf\":{\"@id\":\"https://docs.targeter.tech#website\"},\"breadcrumb\":{\"@id\":\"https://docs.targeter.tech/integrations/setup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.targeter.tech/integrations/setup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.targeter.tech/integrations/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Setup\",\"item\":\"https://docs.targeter.tech/integrations/setup\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.targeter.tech/integrations/setup#article\",\"headline\":\"Setup\",\"name\":\"Setup\",\"description\":\"What Targeter needs from a publisher before it can call your API\",\"url\":\"https://docs.targeter.tech/integrations/setup\",\"mainEntityOfPage\":{\"@id\":\"https://docs.targeter.tech/integrations/setup#webpage\"},\"dateModified\":\"2026-11-16T11:48:12.485Z\",\"publisher\":{\"@id\":\"https://docs.targeter.tech/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.targeter.tech#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Targeter API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Targeter API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/setup.md","siteName":"Targeter API","nav":{"global":null,"tabs":[{"tab":"API","pages":[{"title":"API","href":""}]},{"tab":"Integrations","groups":[{"group":"Getting started","pages":[{"title":"Publisher integrations","description":"Ideal API contract for platforms Targeter creates ads on and fetches insights from","href":"/integrations/introduction"},{"title":"Setup","href":"/integrations/setup"}]},{"group":"Offices","pages":[{"title":"Create office","description":"Create a broker or advertiser office; the publisher generates office_id","openapi":"integrations/openapi.json POST /offices","href":"/integrations/offices/create"},{"title":"Get office ID","openapi":"integrations/openapi.json GET /offices","href":"/integrations/offices/get"}]},{"group":"Ads","pages":[{"title":"Create ad","openapi":"integrations/openapi.json POST /ads","href":"/integrations/ads/create"},{"title":"Update ad","openapi":"integrations/openapi.json PATCH /ads/{ad_id}","href":"/integrations/ads/update"},{"title":"Delete ad","openapi":"integrations/openapi.json DELETE /ads/{ad_id}","href":"/integrations/ads/delete"},{"title":"Pause ad","openapi":"integrations/openapi.json POST /ads/{ad_id}/pause","href":"/integrations/ads/pause"},{"title":"Resume ad","openapi":"integrations/openapi.json POST /ads/{ad_id}/resume","href":"/integrations/ads/resume"},{"title":"Get ad status","openapi":"integrations/openapi.json GET /ads/{ad_id}/status","href":"/integrations/ads/status"}]},{"group":"Insights","pages":[{"title":"Fetch insight","openapi":"integrations/openapi.json GET /ads/{ad_id}/insights","href":"/integrations/insights/fetch"}]},{"group":"Platforms","pages":[{"title":"Get publisher platforms","openapi":"integrations/openapi.json GET /publisher-platforms","href":"/integrations/platforms/get"}]}]}]},"basePath":"","title":"Setup - Targeter API","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}