Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.
Before you create a promotion, fetch the IDs for your organisation’s products, channels, jurisdictions, and target markets. You pass these IDs when you create the promotion, and they determine which regulatory rules apply during evaluation.
Classification drives the rules. The products, channels, and jurisdiction you set decide which rules run during evaluation. Incorrect classification produces irrelevant findings.
Endpoints
Each endpoint returns its items under a named key alongside a correlationId, sorted alphabetically by name. See the full request, response schema, and a live request in the API reference:
List products
List channels
List jurisdictions
List target markets
These values change infrequently. Cache them and refresh daily rather than fetching them on every request.
Creating promotions
Combine these IDs with your uploaded files.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Adclear Manual","colors":{"primary":"#445190","light":"#88B2C7","dark":"#445190"},"logo":{"light":"https://mintcdn.com/adclearai-9f68cd27/DZvx_rvLjmqDQmQn/logo/Adclear_Logo_Black.svg?fit=max\u0026auto=format\u0026n=DZvx_rvLjmqDQmQn\u0026q=85\u0026s=a2df87a875986be326977eae8454db01","dark":"https://mintcdn.com/adclearai-9f68cd27/DZvx_rvLjmqDQmQn/logo/Adclear_Logo_White.svg?fit=max\u0026auto=format\u0026n=DZvx_rvLjmqDQmQn\u0026q=85\u0026s=ea5cdcc7df60884fd2cfb62bd9976a6d"},"favicon":"https://mintcdn.com/adclearai-9f68cd27/4INiEjuytmtY4ccH/favicon.ico?fit=max\u0026auto=format\u0026n=4INiEjuytmtY4ccH\u0026q=85\u0026s=649be67018c6ce377346f7a5fb2b9262","api":{"mdx":{"auth":{"method":"bearer"}}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FAFAF9"}},"navbar":{"links":[{"href":"https://www.adclear.ai/","label":"About"},{"href":"https://www.adclear.ai/adclear/contact","label":"Contact"}],"primary":{"type":"button","label":"Go to app","href":"https://app.adclear.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/adclear-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adclearai-9f68cd27","hasAudioNarration":false,"actualSubdomain":"adclearai-9f68cd27","customDomains":["docs.adclear.ai"],"gitSource":{"type":"github","owner":"adclear-ai","repo":"adclear-platform","deployBranch":"main","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff1e9c0e009609935212e9","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Guides","count":64},{"language":"default","tag":"Developer","count":42},{"language":"default","tag":"Adclear API","count":26},{"language":"default","tag":"Marketing Guide","count":20},{"language":"default","tag":"Core Concepts","count":12},{"language":"default","tag":"Compliance Guide","count":11},{"language":"default","tag":"Fundamentals","count":8},{"language":"default","tag":"Uploading","count":8},{"language":"default","tag":"Workflows","count":7},{"language":"default","tag":"Webhooks","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"developer/reference-data","slug":"/developer/reference-data","pageMetadata":{"title":"Reference data","description":"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.","href":"/developer/reference-data"},"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: \"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Before you create a promotion, fetch the IDs for your organisation’s products, channels, jurisdictions, and target markets. You pass these IDs when you create the promotion, and they determine which regulatory rules apply during evaluation.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Classification drives the rules. The products, channels, and jurisdiction you set decide which rules run during evaluation. Incorrect classification produces irrelevant findings.`})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsxs(_components.p,{children:[`Each endpoint returns its items under a named key alongside a `,_jsx(_components.code,{children:`correlationId`}),`, sorted alphabetically by name. See the full request, response schema, and a live request in the API reference:`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`List products`,icon:`box`,href:`/api-reference/api/list-products`}),_jsx(Card,{title:`List channels`,icon:`tower-broadcast`,href:`/api-reference/api/list-channels`}),_jsx(Card,{title:`List jurisdictions`,icon:`scale-balanced`,href:`/api-reference/api/list-jurisdictions`}),_jsx(Card,{title:`List target markets`,icon:`bullseye`,href:`/api-reference/api/list-target-markets`})]}),`\n`,_jsx(_components.p,{children:`These values change infrequently. Cache them and refresh daily rather than fetching them on every request.`}),`\n`,_jsx(CardGroup,{cols:2,children:_jsx(Card,{title:`Creating promotions`,icon:`bullhorn`,href:`/developer/promotions`,children:_jsx(_components.p,{children:`Combine these IDs with your uploaded files.`})})})]})}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":"Reference data","description":"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.","href":"/developer/reference-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoints","slug":"endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"adclearai-9f68cd27","siteName":"Adclear Manual","title":"Reference data - Adclear Manual","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-01T08:43:49.648Z","originalFileLocation":"developer/reference-data.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Adclear Manual\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Reference data - Adclear Manual\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Adclear Manual\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adclear.ai/developer/reference-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adclearai-9f68cd27.mintlify.site/_mintlify/api/og/v2?division=Fundamentals\u0026amp;title=Reference+data\u0026amp;description=Fetch+the+product%2C+channel%2C+jurisdiction%2C+and+target-market+IDs+your+organisation+uses+to+classify+a+promotion.\u0026amp;theme=35c42ad347e37858b20ce684\u0026amp;signature=0ba806b2a4e1a14d126fca434f00fbf4295fb77f354eb52ad25cf0e3fef6af04\">\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=\"Reference data - Adclear Manual\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adclearai-9f68cd27.mintlify.site/_mintlify/api/og/v2?division=Fundamentals\u0026amp;title=Reference+data\u0026amp;description=Fetch+the+product%2C+channel%2C+jurisdiction%2C+and+target-market+IDs+your+organisation+uses+to+classify+a+promotion.\u0026amp;theme=35c42ad347e37858b20ce684\u0026amp;signature=0ba806b2a4e1a14d126fca434f00fbf4295fb77f354eb52ad25cf0e3fef6af04\">\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/adclearai-9f68cd27/kuXBVazU8K6LynAx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Adclear Manual\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#445190\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.adclear.ai/developer/reference-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developer/reference-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.adclear.ai/#organization\",\"name\":\"Adclear Manual\",\"url\":\"https://docs.adclear.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/adclearai-9f68cd27/DZvx_rvLjmqDQmQn/logo/Adclear_Logo_Black.svg?fit=max\u0026auto=format\u0026n=DZvx_rvLjmqDQmQn\u0026q=85\u0026s=a2df87a875986be326977eae8454db01\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.adclear.ai#website\",\"name\":\"Adclear Manual\",\"url\":\"https://docs.adclear.ai\",\"publisher\":{\"@id\":\"https://docs.adclear.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.adclear.ai/developer/reference-data#webpage\",\"url\":\"https://docs.adclear.ai/developer/reference-data\",\"name\":\"Reference data\",\"description\":\"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.\",\"dateModified\":\"2026-07-01T08:43:49.648Z\",\"isPartOf\":{\"@id\":\"https://docs.adclear.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adclear.ai/developer/reference-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adclear.ai/developer/reference-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Adclear Manual\",\"item\":\"https://docs.adclear.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Reference data\",\"item\":\"https://docs.adclear.ai/developer/reference-data\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.adclear.ai/developer/reference-data#article\",\"headline\":\"Reference data\",\"name\":\"Reference data\",\"description\":\"Fetch the product, channel, jurisdiction, and target-market IDs your organisation uses to classify a promotion.\",\"url\":\"https://docs.adclear.ai/developer/reference-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adclear.ai/developer/reference-data#webpage\"},\"dateModified\":\"2026-07-01T08:43:49.648Z\",\"publisher\":{\"@id\":\"https://docs.adclear.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.adclear.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Adclear Manual\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Adclear Manual\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developer/reference-data.md","siteName":"Adclear Manual","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Developer","groups":[{"group":"Get started","pages":[{"title":"Introduction","href":"/developer/introduction"},{"title":"Quickstart","href":"/developer/quickstart"},{"title":"Authentication","href":"/developer/authentication"},{"title":"MCP for developers","sidebarTitle":"MCP","description":"Connect your own agent to the Adclear MCP server. OAuth, workspaces, file uploads, retries, rate limits and errors.","href":"/developer/mcp"}]},{"group":"Fundamentals","pages":[{"title":"Reference data","href":"/developer/reference-data"},{"title":"File upload","description":"Upload files to the File API with the resumable chunked protocol, then reference them when creating a promotion.","href":"/developer/file-upload"},{"title":"Link submission","href":"/developer/links"},{"title":"Creating promotions","href":"/developer/promotions"},{"title":"Evaluation","href":"/developer/evaluation"},{"title":"Comments","href":"/developer/comments"},{"title":"Legacy webhooks","sidebarTitle":"Webhooks","href":"/developer/legacy-webhooks"},{"title":"Errors \u0026 rate limits","href":"/developer/errors"}]},{"group":"Webhooks","hidden":true,"pages":[{"title":"Webhooks","href":"/developer/webhooks"},{"title":"Webhook events","href":"/developer/webhook-events"},{"group":"Recipes","pages":[{"title":"Webhook recipes","sidebarTitle":"Overview","href":"/developer/webhook-recipes"},{"title":"Catch Adclear events in Zapier","href":"/developer/webhook-recipes/catch-events-in-zapier"},{"title":"Post review decisions to Slack","href":"/developer/webhook-recipes/slack-review-decisions"},{"title":"Share compliance comments in Slack","href":"/developer/webhook-recipes/slack-compliance-comments"},{"title":"Raise Jira issues from evaluation findings","href":"/developer/webhook-recipes/jira-evaluation-issues"},{"title":"Track promotions in Jira","href":"/developer/webhook-recipes/jira-promotion-tracking"}]}]},{"group":"Adclear API","pages":[{"group":"Promotions","pages":[{"title":"Create promotion","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions","href":"/api-reference/api/promotions/create-promotion"},{"title":"Get promotion","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json get /v1/promotions/{promotionId}","href":"/api-reference/api/promotions/get-promotion"},{"title":"Create version","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions/{promotionId}/versions","href":"/api-reference/api/promotions/create-version"},{"title":"Submit version for review","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions/{promotionId}/versions/{versionId}/submit","href":"/api-reference/api/promotions/submit-version-for-review"}]},{"group":"Links","pages":[{"title":"Submit a link","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/links","href":"/api-reference/api/links/submit-a-link"},{"title":"List Figma frames","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/links/figma/frames","href":"/api-reference/api/links/list-figma-frames"},{"title":"Get link import status","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json get /v1/links/{uploadId}","href":"/api-reference/api/links/get-link-import-status"}]},{"group":"Evaluation","pages":[{"title":"Trigger evaluation","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions/{promotionId}/versions/{versionId}/evaluate","href":"/api-reference/api/evaluation/trigger-evaluation"},{"title":"Get evaluation","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json get /v1/promotions/{promotionId}/versions/{versionId}/evaluation","href":"/api-reference/api/evaluation/get-evaluation"},{"title":"Get comments","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json get /v1/promotions/{promotionId}/versions/{versionId}/comments","href":"/api-reference/api/evaluation/get-comments"},{"title":"Import comments","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions/{promotionId}/versions/{versionId}/comments","href":"/api-reference/api/evaluation/import-comments"},{"title":"Update comments","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json patch /v1/promotions/{promotionId}/versions/{versionId}/comments","href":"/api-reference/api/evaluation/update-comments"}]},{"group":"Review","pages":[{"title":"Get decision","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json get /v1/promotions/{promotionId}/versions/{versionId}/decision","href":"/api-reference/api/review/get-decision"},{"title":"Record decision","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions/{promotionId}/versions/{versionId}/decision","href":"/api-reference/api/review/record-decision"},{"title":"Assign or change reviewer","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json put /v1/promotions/{promotionId}/versions/{versionId}/reviewer","href":"/api-reference/api/review/assign-or-change-reviewer"},{"title":"Unassign reviewer","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json delete /v1/promotions/{promotionId}/versions/{versionId}/reviewer","href":"/api-reference/api/review/unassign-reviewer"}]},{"group":"Reference Data","pages":[{"title":"List products","deprecated":null,"version":null,"sidebarTitle":"List products","openapi":"/openapi/integration-api.json get /v1/products","href":"/api-reference/api/list-products"},{"title":"List channels","deprecated":null,"version":null,"sidebarTitle":"List channels","openapi":"/openapi/integration-api.json get /v1/channels","href":"/api-reference/api/list-channels"},{"title":"List jurisdictions","deprecated":null,"version":null,"sidebarTitle":"List jurisdictions","openapi":"/openapi/integration-api.json get /v1/jurisdictions","href":"/api-reference/api/list-jurisdictions"},{"title":"List target markets","deprecated":null,"version":null,"sidebarTitle":"List target markets","openapi":"/openapi/integration-api.json get /v1/target-markets","href":"/api-reference/api/list-target-markets"}]},{"group":"Webhooks","pages":[{"title":"Evaluation completed","version":null,"deprecated":null,"openapi":"/openapi/integration-api.json webhook evaluation-completed","href":"/api-reference/api/webhooks/evaluation-completed"},{"title":"Comment created","version":null,"deprecated":null,"openapi":"/openapi/integration-api.json webhook comment.created","href":"/api-reference/api/webhooks/comment-created"},{"title":"Review submitted","version":null,"deprecated":null,"openapi":"/openapi/integration-api.json webhook review.submitted","href":"/api-reference/api/webhooks/review-submitted"},{"title":"Review approved","version":null,"deprecated":null,"openapi":"/openapi/integration-api.json webhook review.approved","href":"/api-reference/api/webhooks/review-approved"},{"title":"Review changes requested","version":null,"deprecated":null,"openapi":"/openapi/integration-api.json webhook review.changes_requested","href":"/api-reference/api/webhooks/review-changes-requested"},{"title":"Review rejected","version":null,"deprecated":null,"openapi":"/openapi/integration-api.json webhook review.rejected","href":"/api-reference/api/webhooks/review-rejected"}]}]},{"group":"File API","pages":[{"group":"Upload","pages":[{"title":"Initiate upload","deprecated":null,"version":null,"openapi":"/openapi/file-api.json post /v1/uploads","href":"/api-reference/file-api/upload/initiate-upload"},{"title":"Get upload status","deprecated":null,"version":null,"openapi":"/openapi/file-api.json get /v1/uploads/{uploadId}","href":"/api-reference/file-api/upload/get-upload-status"},{"title":"Upload chunk","deprecated":null,"version":null,"openapi":"/openapi/file-api.json put /v1/uploads/{uploadId}","href":"/api-reference/file-api/upload/upload-chunk"},{"title":"Delete upload","deprecated":null,"version":null,"openapi":"/openapi/file-api.json delete /v1/uploads/{uploadId}","href":"/api-reference/file-api/upload/delete-upload"}]}]}]},{"tab":"What's new","pages":[{"title":"What's new","href":"/changelog"}]}]},"basePath":"","title":"Reference data - Adclear Manual","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}