Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.
Identifier of the acting user in the calling system (e.g. a Workfront user id). Recorded against every audited action this request performs.
X-External-User-Email
string<email>
Acting user email. Only meaningful on keys with act-on-behalf enabled, where it is resolved to the matching Adclear user and is mandatory on writes. Ignored on ordinary keys.
Body
application/json
promotionName
string
required
Display name for the promotion
Minimum string length: 1
productIds
string<uuid>[]
required
Product IDs (from /v1/products)
Minimum array length: 1
uploadIds
string<uuid>[]
Upload IDs from the File API. Required for file-based formats (pdf, image, video, etc.). Must be omitted when fileFormat is "text".
content
string
Inline text or HTML content. Required when fileFormat is "text". Must be omitted for file-based formats.
Minimum string length: 1
fileFormat
enum<string>
Content format (text, video, audio, image, pdf, document)
Available options:
text,
video,
audio,
image,
pdf,
document
channelIds
string<uuid>[]
Channel IDs (from /v1/channels)
Minimum array length: 1
jurisdictionId
string<uuid>
Jurisdiction ID (from /v1/jurisdictions)
deadline
stringstring<date-time>
Deadline as YYYY-MM-DD calendar date or ISO 8601 datetime
paidPromotion
boolean
Whether this is a paid promotion
isFinancialPromotion
boolean
Whether this is a financial promotion. Defaults to true when omitted. Setting false marks the promotion as explicitly not a financial promotion, which skips the compliance evaluation.
evergreen
boolean
Whether this promotion is evergreen (no expiry)
nextReviewDate
string<date-time> | null
Next review date in ISO 8601 format. Only valid with evergreen: true; the promotion is reminded about and expired on this date.
caption
string
details
string
Additional reviewer context for the promotion (shown as "Additional details" in the Adclear UI). Free text, up to 1500 characters.
Maximum string length: 1500
type
enum<string>
Promotion type (single, carousel, variations)
Available options:
single,
carousel,
variations
linkedClaimIds
string<uuid>[]
targetMarketIds
string<uuid>[]
applyToAllTargetMarkets
boolean
metadata
object
Arbitrary key-value pairs stored with the promotion and echoed back in webhook payloads. Max 20 keys. Keys: alphanumeric/underscore/hyphen, max 128 chars. Values: max 1024 chars. Do not store PII, credentials, or sensitive data.
Create a linked variation set in one request. Mutually exclusive with top-level uploadIds, content, and fileFormat.
Required array length: 2 - 20 elements
Show child attributes
tags
string[] | null
Tag names to attach to the promotion. Existing tags are reused; unknown names are created. Names are trimmed, and duplicates within one request are ignored. Tags belong to the promotion, so they are shared by all of its versions. Max 20 tags, each up to 255 characters. Names beginning with "Var-" and the name "TESTING" are reserved.
Example:
["Q1 Campaign", "retail"]
Response
Promotion created
Option 1
Option 2
promotionId
string<uuid>
required
versionId
string<uuid>
required
version
integer
required
Auto-derived version number
correlationId
string<uuid>
required
Correlation ID for request tracing. Include in support requests.
publicId
string
Human-readable promotion ID, when available
metadata
object
Stored metadata echoed back for confirmation
Show child attributes
tags
string[]
Tag names actually attached, echoed back for confirmation. Empty when tags were requested but could not be attached — the promotion is still created, and the request can be retried by adding the tags separately.
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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"api-reference/api/promotions/create-promotion","slug":"/api-reference/api/promotions/create-promotion","pageMetadata":{"title":"Create promotion","description":"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions","href":"/api-reference/api/promotions/create-promotion","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create promotion","description":"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.","deprecated":null,"version":null,"openapi":"/openapi/integration-api.json post /v1/promotions","href":"/api-reference/api/promotions/create-promotion","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Promotions"],"summary":"Create promotion","description":"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.","operationId":"createPromotion","security":["391ceef3-b5fb-4578-a64c-edf56edc9b4e"],"requestBody":"35715d94-8350-4c4a-bb68-4081f0ee4ff5","responses":{"201":"1a8316c6-181b-4f98-841a-0d2caff7600e","400":"94054764-2f7e-48b2-9e3f-1e80fba39b33","401":"45751f19-c1d2-4193-8121-f04f1f784d21","403":"e4af4931-24e7-43fd-958b-f60e8a3b42d9","409":"1d7d93be-2dc9-4e36-b996-a82c4c7270c7","429":"7c74b18a-ef18-4889-afc5-44c3269d7516","500":"017aaaa5-9879-48ef-8d5c-6b7868c2af61"},"parameters":["e01466a5-b4b1-4539-8f09-91223f9d27f4","ecc78978-dd90-4bd8-909c-3e960a1a5e18"],"method":"post","type":"path","servers":["904f2bce-2912-4fd3-aa68-394cd8cdbf4b","2e996a56-4c31-4af0-8ae4-a9c3476b5e4c"],"path":"/v1/promotions","baseUrlOptions":["https://public-api.adclear.ai","https://public-api-staging.adclear.ai"],"title":"Create promotion","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e01466a5-b4b1-4539-8f09-91223f9d27f4":{"name":"X-External-User-ID","in":"header","required":true,"schema":{"type":"string","isRequired":true,"description":"Identifier of the acting user in the calling system (e.g. a Workfront user id). Recorded against every audited action this request performs.","uniqueKey":"","typeLabel":"string"},"description":"Identifier of the acting user in the calling system (e.g. a Workfront user id). Recorded against every audited action this request performs."},"ecc78978-dd90-4bd8-909c-3e960a1a5e18":{"name":"X-External-User-Email","in":"header","required":false,"schema":{"type":"string","format":"email","isRequired":false,"description":"Acting user email. Only meaningful on keys with act-on-behalf enabled, where it is resolved to the matching Adclear user and is mandatory on writes. Ignored on ordinary keys.","uniqueKey":"","typeLabel":"string\u003cemail>"},"description":"Acting user email. Only meaningful on keys with act-on-behalf enabled, where it is resolved to the matching Adclear user and is mandatory on writes. Ignored on ordinary keys."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"promotionName":{"type":"string","minLength":1,"description":"Display name for the promotion","isRequired":true,"uniqueKey":"promotionName","typeLabel":"string"},"productIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"productIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"minItems":1,"description":"Product IDs (from /v1/products)","isRequired":true,"uniqueKey":"productIds","typeLabel":"string\u003cuuid>[]"},"uploadIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"uploadIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Upload IDs from the File API. Required for file-based formats (pdf, image, video, etc.). Must be omitted when fileFormat is \"text\".","uniqueKey":"uploadIds","typeLabel":"string\u003cuuid>[]"},"content":{"type":"string","minLength":1,"description":"Inline text or HTML content. Required when fileFormat is \"text\". Must be omitted for file-based formats.","uniqueKey":"content","typeLabel":"string"},"fileFormat":{"type":"string","enum":["text","video","audio","image","pdf","document"],"description":"Content format (text, video, audio, image, pdf, document)","uniqueKey":"fileFormat","typeLabel":"enum\u003cstring>"},"channelIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"channelIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"minItems":1,"description":"Channel IDs (from /v1/channels)","uniqueKey":"channelIds","typeLabel":"string\u003cuuid>[]"},"jurisdictionId":{"type":"string","format":"uuid","description":"Jurisdiction ID (from /v1/jurisdictions)","uniqueKey":"jurisdictionId","typeLabel":"string\u003cuuid>"},"deadline":{"oneOf":[{"type":"string","description":"Deadline as YYYY-MM-DD calendar date or ISO 8601 datetime","uniqueKey":"deadline.oneOf.0","typeLabel":"string"},{"type":"string","description":"Deadline as YYYY-MM-DD calendar date or ISO 8601 datetime","format":"date-time","uniqueKey":"deadline.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"deadline","typeLabel":"string | string\u003cdate-time>"},"paidPromotion":{"type":"boolean","description":"Whether this is a paid promotion","uniqueKey":"paidPromotion","typeLabel":"boolean"},"isFinancialPromotion":{"type":"boolean","description":"Whether this is a financial promotion. Defaults to true when omitted. Setting false marks the promotion as explicitly not a financial promotion, which skips the compliance evaluation.","uniqueKey":"isFinancialPromotion","typeLabel":"boolean"},"evergreen":{"type":"boolean","description":"Whether this promotion is evergreen (no expiry)","uniqueKey":"evergreen","typeLabel":"boolean"},"nextReviewDate":{"oneOf":[{"type":"string","format":"date-time","description":"Next review date in ISO 8601 format. Only valid with evergreen: true; the promotion is reminded about and expired on this date.","uniqueKey":"nextReviewDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Next review date in ISO 8601 format. Only valid with evergreen: true; the promotion is reminded about and expired on this date.","uniqueKey":"nextReviewDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextReviewDate","typeLabel":"string\u003cdate-time> | null"},"caption":{"type":"string","uniqueKey":"caption","typeLabel":"string"},"details":{"type":"string","maxLength":1500,"description":"Additional reviewer context for the promotion (shown as \"Additional details\" in the Adclear UI). Free text, up to 1500 characters.","uniqueKey":"details","typeLabel":"string"},"type":{"type":"string","enum":["single","carousel","variations"],"description":"Promotion type (single, carousel, variations)","uniqueKey":"type","typeLabel":"enum\u003cstring>"},"linkedClaimIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"linkedClaimIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"linkedClaimIds","typeLabel":"string\u003cuuid>[]"},"targetMarketIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"targetMarketIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"targetMarketIds","typeLabel":"string\u003cuuid>[]"},"applyToAllTargetMarkets":{"type":"boolean","uniqueKey":"applyToAllTargetMarkets","typeLabel":"boolean"},"metadata":{"type":"object","additionalProperties":{"type":"string","maxLength":1024,"uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"description":"Arbitrary key-value pairs stored with the promotion and echoed back in webhook payloads. Max 20 keys. Keys: alphanumeric/underscore/hyphen, max 128 chars. Values: max 1024 chars. Do not store PII, credentials, or sensitive data.","example":{"workfrontProjectId":"PROJ-123","workfrontTaskId":"TASK-456","workfrontDocumentId":"DOC-789"},"uniqueKey":"metadata","typeLabel":"object"},"variations":{"type":"array","items":{"type":"object","properties":{"fileFormat":{"type":"string","enum":["text","video","audio","image","pdf","document"],"description":"Content format (text, video, audio, image, pdf, document)","isRequired":true,"uniqueKey":"variations.items.[INDEX].fileFormat","typeLabel":"enum\u003cstring>"},"channelIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"variations.items.[INDEX].channelIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"minItems":1,"description":"Channel IDs (from /v1/channels)","isRequired":true,"uniqueKey":"variations.items.[INDEX].channelIds","typeLabel":"string\u003cuuid>[]"},"jurisdictionId":{"type":"string","format":"uuid","description":"Jurisdiction ID (from /v1/jurisdictions)","isRequired":true,"uniqueKey":"variations.items.[INDEX].jurisdictionId","typeLabel":"string\u003cuuid>"},"uploadId":{"type":"string","format":"uuid","description":"Upload ID from the File API. Required for file-based formats, omitted when fileFormat is \"text\". One file per variation — use the carousel promotion type for multi-file content.","uniqueKey":"variations.items.[INDEX].uploadId","typeLabel":"string\u003cuuid>"},"content":{"type":"string","minLength":1,"description":"Inline text or HTML content. Required when fileFormat is \"text\". Must be omitted for file-based formats.","uniqueKey":"variations.items.[INDEX].content","typeLabel":"string"},"caption":{"type":"string","uniqueKey":"variations.items.[INDEX].caption","typeLabel":"string"},"details":{"type":"string","maxLength":1500,"description":"Additional reviewer context for this variation (shown as \"Additional details\" in the Adclear UI). Free text, up to 1500 characters.","uniqueKey":"variations.items.[INDEX].details","typeLabel":"string"},"linkedClaimIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"variations.items.[INDEX].linkedClaimIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Claim IDs to link to this variation","uniqueKey":"variations.items.[INDEX].linkedClaimIds","typeLabel":"string\u003cuuid>[]"},"targetMarketIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"variations.items.[INDEX].targetMarketIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Target market IDs for this variation","uniqueKey":"variations.items.[INDEX].targetMarketIds","typeLabel":"string\u003cuuid>[]"},"applyToAllTargetMarkets":{"type":"boolean","uniqueKey":"variations.items.[INDEX].applyToAllTargetMarkets","typeLabel":"boolean"}},"required":["fileFormat","channelIds","jurisdictionId"],"uniqueKey":"variations.items.[INDEX]","typeLabel":"object"},"minItems":2,"maxItems":20,"description":"Create a linked variation set in one request. Mutually exclusive with top-level uploadIds, content, and fileFormat.","uniqueKey":"variations","typeLabel":"object[]"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Tag names to attach to the promotion. Existing tags are reused; unknown names are created. Names are trimmed, and duplicates within one request are ignored. Tags belong to the promotion, so they are shared by all of its versions. Max 20 tags, each up to 255 characters. Names beginning with \"Var-\" and the name \"TESTING\" are reserved.","example":["Q1 Campaign","retail"],"uniqueKey":"tags.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Tag names to attach to the promotion. Existing tags are reused; unknown names are created. Names are trimmed, and duplicates within one request are ignored. Tags belong to the promotion, so they are shared by all of its versions. Max 20 tags, each up to 255 characters. Names beginning with \"Var-\" and the name \"TESTING\" are reserved.","example":["Q1 Campaign","retail"],"uniqueKey":"tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"tags","typeLabel":"string[] | null"}},"required":["promotionName","productIds"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"promotionName":"\u003cstring>","productIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"uploadIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"content":"\u003cstring>","channelIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"jurisdictionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","deadline":"\u003cstring>","paidPromotion":true,"isFinancialPromotion":true,"evergreen":true,"nextReviewDate":"2023-11-07T05:31:56Z","caption":"\u003cstring>","details":"\u003cstring>","linkedClaimIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"targetMarketIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"applyToAllTargetMarkets":true,"metadata":{"workfrontProjectId":"PROJ-123","workfrontTaskId":"TASK-456","workfrontDocumentId":"DOC-789"},"variations":[{"channelIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"jurisdictionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","uploadId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","content":"\u003cstring>","caption":"\u003cstring>","details":"\u003cstring>","linkedClaimIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"targetMarketIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"applyToAllTargetMarkets":true}],"tags":["Q1 Campaign","retail"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1a8316c6-181b-4f98-841a-0d2caff7600e":{"description":"Promotion created","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["promotionId","versionId","version","correlationId"],"properties":{"promotionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.promotionId","typeLabel":"string\u003cuuid>"},"versionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.versionId","typeLabel":"string\u003cuuid>"},"version":{"type":"integer","exclusiveMinimum":0,"description":"Auto-derived version number","isRequired":true,"uniqueKey":"oneOf.0.version","typeLabel":"integer"},"correlationId":{"type":"string","format":"uuid","description":"Correlation ID for request tracing. Include in support requests.","isRequired":true,"uniqueKey":"oneOf.0.correlationId","typeLabel":"string\u003cuuid>"},"publicId":{"type":"string","description":"Human-readable promotion ID, when available","uniqueKey":"oneOf.0.publicId","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"oneOf.0.metadata.additionalProperties","typeLabel":"string"},"description":"Stored metadata echoed back for confirmation","uniqueKey":"oneOf.0.metadata","typeLabel":"object"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.tags.items.[INDEX]","typeLabel":"string"},"description":"Tag names actually attached, echoed back for confirmation. Empty when tags were requested but could not be attached — the promotion is still created, and the request can be retried by adding the tags separately.","uniqueKey":"oneOf.0.tags","typeLabel":"string[]"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["variations","correlationId"],"properties":{"variations":{"type":"array","items":{"type":"object","properties":{"promotionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.variations.items.[INDEX].promotionId","typeLabel":"string\u003cuuid>"},"versionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.variations.items.[INDEX].versionId","typeLabel":"string\u003cuuid>"},"version":{"type":"integer","exclusiveMinimum":0,"description":"Auto-derived version number","isRequired":true,"uniqueKey":"oneOf.1.variations.items.[INDEX].version","typeLabel":"integer"},"publicId":{"type":"string","description":"Human-readable variation ID, when available","uniqueKey":"oneOf.1.variations.items.[INDEX].publicId","typeLabel":"string"}},"required":["promotionId","versionId","version"],"uniqueKey":"oneOf.1.variations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.variations","typeLabel":"object[]"},"correlationId":{"type":"string","format":"uuid","description":"Correlation ID for request tracing. Include in support requests.","isRequired":true,"uniqueKey":"oneOf.1.correlationId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"promotionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","versionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","version":123,"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","publicId":"\u003cstring>","metadata":{},"tags":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"94054764-2f7e-48b2-9e3f-1e80fba39b33":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","INVALID_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INTERNAL_ERROR","UPSTREAM_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","field","message"],"properties":{"type":{"type":"string","enum":["field_error"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","constraint","limit","actual"],"properties":{"type":{"type":"string","enum":["constraint_violation"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.constraint","typeLabel":"string"},"limit":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.limit","typeLabel":"number"},"actual":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.actual","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","retryAfterSeconds"],"properties":{"type":{"type":"string","enum":["retry_info"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","uploadId"],"properties":{"type":{"type":"string","enum":["upload_not_ready"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.uploadId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"error.details.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"correlationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"correlationId","typeLabel":"string\u003cuuid>"}},"required":["error","correlationId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","details":[{"type":"field_error","field":"\u003cstring>","message":"\u003cstring>"}]},"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"45751f19-c1d2-4193-8121-f04f1f784d21":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","INVALID_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INTERNAL_ERROR","UPSTREAM_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","field","message"],"properties":{"type":{"type":"string","enum":["field_error"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","constraint","limit","actual"],"properties":{"type":{"type":"string","enum":["constraint_violation"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.constraint","typeLabel":"string"},"limit":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.limit","typeLabel":"number"},"actual":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.actual","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","retryAfterSeconds"],"properties":{"type":{"type":"string","enum":["retry_info"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","uploadId"],"properties":{"type":{"type":"string","enum":["upload_not_ready"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.uploadId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"error.details.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"correlationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"correlationId","typeLabel":"string\u003cuuid>"}},"required":["error","correlationId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","details":[{"type":"field_error","field":"\u003cstring>","message":"\u003cstring>"}]},"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"e4af4931-24e7-43fd-958b-f60e8a3b42d9":{"description":"Forbidden — the API key's scope or the acting user's permissions do not allow this operation","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","INVALID_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INTERNAL_ERROR","UPSTREAM_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","field","message"],"properties":{"type":{"type":"string","enum":["field_error"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","constraint","limit","actual"],"properties":{"type":{"type":"string","enum":["constraint_violation"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.constraint","typeLabel":"string"},"limit":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.limit","typeLabel":"number"},"actual":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.actual","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","retryAfterSeconds"],"properties":{"type":{"type":"string","enum":["retry_info"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","uploadId"],"properties":{"type":{"type":"string","enum":["upload_not_ready"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.uploadId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"error.details.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"correlationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"correlationId","typeLabel":"string\u003cuuid>"}},"required":["error","correlationId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","details":[{"type":"field_error","field":"\u003cstring>","message":"\u003cstring>"}]},"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"1d7d93be-2dc9-4e36-b996-a82c4c7270c7":{"description":"One or more uploads are not ready — the file has not finished uploading to storage. Retry after a short delay. The `details` array contains `upload_not_ready` entries with the offending `uploadId`(s).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","INVALID_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INTERNAL_ERROR","UPSTREAM_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","field","message"],"properties":{"type":{"type":"string","enum":["field_error"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","constraint","limit","actual"],"properties":{"type":{"type":"string","enum":["constraint_violation"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.constraint","typeLabel":"string"},"limit":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.limit","typeLabel":"number"},"actual":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.actual","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","retryAfterSeconds"],"properties":{"type":{"type":"string","enum":["retry_info"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","uploadId"],"properties":{"type":{"type":"string","enum":["upload_not_ready"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.uploadId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"error.details.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"correlationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"correlationId","typeLabel":"string\u003cuuid>"}},"required":["error","correlationId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","details":[{"type":"field_error","field":"\u003cstring>","message":"\u003cstring>"}]},"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"7c74b18a-ef18-4889-afc5-44c3269d7516":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","INVALID_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INTERNAL_ERROR","UPSTREAM_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","field","message"],"properties":{"type":{"type":"string","enum":["field_error"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","constraint","limit","actual"],"properties":{"type":{"type":"string","enum":["constraint_violation"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.constraint","typeLabel":"string"},"limit":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.limit","typeLabel":"number"},"actual":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.actual","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","retryAfterSeconds"],"properties":{"type":{"type":"string","enum":["retry_info"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","uploadId"],"properties":{"type":{"type":"string","enum":["upload_not_ready"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.uploadId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"error.details.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"correlationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"correlationId","typeLabel":"string\u003cuuid>"}},"required":["error","correlationId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","details":[{"type":"field_error","field":"\u003cstring>","message":"\u003cstring>"}]},"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"017aaaa5-9879-48ef-8d5c-6b7868c2af61":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR","INVALID_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INTERNAL_ERROR","UPSTREAM_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","field","message"],"properties":{"type":{"type":"string","enum":["field_error"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","constraint","limit","actual"],"properties":{"type":{"type":"string","enum":["constraint_violation"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.constraint","typeLabel":"string"},"limit":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.limit","typeLabel":"number"},"actual":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.1.actual","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","retryAfterSeconds"],"properties":{"type":{"type":"string","enum":["retry_info"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.2.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"error.details.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","uploadId"],"properties":{"type":{"type":"string","enum":["upload_not_ready"],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"uploadId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.details.items.[INDEX].oneOf.3.uploadId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"error.details.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"correlationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"correlationId","typeLabel":"string\u003cuuid>"}},"required":["error","correlationId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","details":[{"type":"field_error","field":"\u003cstring>","message":"\u003cstring>"}]},"correlationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"391ceef3-b5fb-4578-a64c-edf56edc9b4e":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key passed as Bearer token","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"904f2bce-2912-4fd3-aa68-394cd8cdbf4b":{"url":"https://public-api.adclear.ai","description":"Production"},"2e996a56-4c31-4af0-8ae4-a9c3476b5e4c":{"url":"https://public-api-staging.adclear.ai","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key passed as Bearer token","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key passed as Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi/integration-api.json"},"subdomain":"adclearai-9f68cd27","siteName":"Adclear Manual","title":"Create promotion - Adclear Manual","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T13:32:01.570Z","originalFileLocation":"api-reference/api/promotions/create-promotion.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=\"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.\">\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=\"Create promotion - Adclear Manual\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Adclear Manual\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion\">\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=Promotions\u0026amp;title=Create+promotion\u0026amp;description=Creates+a+new+promotion+and+its+first+version.+For+file-based+formats+%28pdf%2C+image%2C+video%2C+etc.%29%2C+upload+files+first+via+the+File+API+and+provide+uploadIds.+For+\u0026amp;theme=35c42ad347e37858b20ce684\u0026amp;signature=40e650fc06ef80804e74f536bd9aa61861a365d9bafea43a18211bcd58d5927b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create promotion - Adclear Manual\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adclearai-9f68cd27.mintlify.site/_mintlify/api/og/v2?division=Promotions\u0026amp;title=Create+promotion\u0026amp;description=Creates+a+new+promotion+and+its+first+version.+For+file-based+formats+%28pdf%2C+image%2C+video%2C+etc.%29%2C+upload+files+first+via+the+File+API+and+provide+uploadIds.+For+\u0026amp;theme=35c42ad347e37858b20ce684\u0026amp;signature=40e650fc06ef80804e74f536bd9aa61861a365d9bafea43a18211bcd58d5927b\">\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/api-reference/api/promotions/create-promotion\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/api/promotions/create-promotion.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/api-reference/api/promotions/create-promotion#webpage\",\"url\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion\",\"name\":\"Create promotion\",\"description\":\"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.\",\"dateModified\":\"2026-11-19T13:32:01.570Z\",\"isPartOf\":{\"@id\":\"https://docs.adclear.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Adclear Manual\",\"item\":\"https://docs.adclear.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create promotion\",\"item\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion#apireference\",\"headline\":\"Create promotion\",\"name\":\"Create promotion\",\"description\":\"Creates a new promotion and its first version. For file-based formats (pdf, image, video, etc.), upload files first via the File API and provide uploadIds. For text format, provide inline content instead of uploadIds. Returns 409 if any referenced upload has not finished uploading to storage.\",\"url\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adclear.ai/api-reference/api/promotions/create-promotion#webpage\"},\"dateModified\":\"2026-11-19T13:32:01.570Z\",\"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":"/api-reference/api/promotions/create-promotion.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","href":"/developer/mcp"}]},{"group":"Fundamentals","pages":[{"title":"Reference data","href":"/developer/reference-data"},{"title":"File upload","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","description":"The shared error envelope, every error code, rate limits, and fixes for the issues integrators hit most.","href":"/developer/errors"}]},{"group":"Webhooks","hidden":true,"pages":[{"title":"Webhooks","description":"Send Adclear events to your own endpoints, check they came from Adclear, and handle retries.","href":"/developer/webhooks"},{"title":"Webhook events","description":"Every event Adclear can send to your webhooks, with an example of each and what the details mean.","href":"/developer/webhook-events"},{"group":"Recipes","pages":[{"title":"Webhook recipes","sidebarTitle":"Overview","description":"Examples of what you can do with Adclear webhooks in Zapier, Slack and Jira.","href":"/developer/webhook-recipes"},{"title":"Catch Adclear events in Zapier","description":"Connect Adclear to a Zap so it runs every time something happens in Adclear.","href":"/developer/webhook-recipes/catch-events-in-zapier"},{"title":"Post review decisions to Slack","description":"Tell a Slack channel when a promotion is approved, rejected or sent back for changes.","href":"/developer/webhook-recipes/slack-review-decisions"},{"title":"Share compliance comments in Slack","description":"Send comments from compliance reviewers to a Slack channel as soon as they're written.","href":"/developer/webhook-recipes/slack-compliance-comments"},{"title":"Raise Jira issues from evaluation findings","description":"Create a Jira issue for each serious problem Adclear finds when it checks a promotion.","href":"/developer/webhook-recipes/jira-evaluation-issues"},{"title":"Track promotions in Jira","description":"Keep one Jira issue for each promotion, with a note added every time its status changes.","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","description":"Returns the promotion's latest version and where it stands in review. Versions can be created through the API or in the Adclear app, so use this to find the latest version rather than tracking it yourself. The latest version is the one with the highest version number.","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":"Create promotion - Adclear Manual","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}