Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.
Current giveaway platform owning the shop's single gifting slot. Read-only conflict signal — TWITCH or STREAMELEMENTS means another integration owns the slot. A Kick shop operates on the OPEN_API slot.
Available options:
TWITCH,
STREAMELEMENTS,
OPEN_API,
NOT_SELECTED
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fourthwall Developer Docs","colors":{"primary":"#000000","light":"#4D4D4D","dark":"#000000"},"logo":{"light":"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/logo/light.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=44d55b19c2c524eb8e4ee5a9de5c89e7","dark":"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/logo/dark.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=6e05cd1920c11af37f6a6c8f6a894ab6"},"favicon":"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/favicon.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=fe14d6128c59ded57a36fe3a5170ffed","api":{"playground":{},"examples":{"prefill":true}},"navbar":{"links":[{"href":"mailto:support@fourthwall.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://my-shop.fourthwall.com/admin/dashboard?redirect"}},"footer":{"socials":{"x":"https://x.com/fourthwall","github":"https://github.com/FourthwallHQ","discord":"https://discord.com/invite/kc6P68z3Uz"}},"integrations":{"gtm":{"tagId":"GTM-W4JTQQ9"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Fourthwall","icon":"globe","href":"https://fourthwall.com"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/kc6P68z3Uz"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fourthwall","hasAudioNarration":false,"actualSubdomain":"fourthwall","customDomains":["docs.fourthwall.com"],"gitSource":{"type":"github","owner":"fourthwallhq","repo":"fourthwall-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab1104d59f5ab6f0ec12dfe","collectionId":"2a83a7c1-c7ba-48bb-a233-753e7c4760cf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab1104d59f5ab6f0ec12dfe"},"entitlements":{},"buildId":"6ab1104d59f5ab6f0ec12dfe","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Platform API","count":78},{"language":"default","tag":"Guides","count":57},{"language":"default","tag":"Memberships API","count":34},{"language":"default","tag":"Webhook Events","count":21},{"language":"default","tag":"Webhooks","count":16},{"language":"default","tag":"Posts","count":15},{"language":"default","tag":"HTML Sections","count":14},{"language":"default","tag":"Channel API","count":10},{"language":"default","tag":"Collections","count":10},{"language":"default","tag":"Products","count":10}]},"assistantConfig":{"enableStarterQuestions":false},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/platform/gifting/update-gifting-config","slug":"/api-reference/platform/gifting/update-gifting-config","pageMetadata":{"title":"Update gifting config","openapi":"PUT /open-api/v1.0/gifting/config","hidden":true,"description":"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.","href":"/api-reference/platform/gifting/update-gifting-config","hiddenSetByFrontmatter":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: \"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.\"\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`,strong:`strong`,..._provideComponents(),...props.components},{Note,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsx(_components.p,{children:`This endpoint is in beta and subject to change.`})}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`OAuth scope:`}),` `,_jsx(_components.code,{children:`giveaway_write`})]}),_jsx(_components.p,{children:`API keys have full access to this endpoint.`})]})]})}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":"Update gifting config","openapi":"PUT /open-api/v1.0/gifting/config","hidden":true,"description":"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.","href":"/api-reference/platform/gifting/update-gifting-config","hiddenSetByFrontmatter":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Gifting"],"summary":"Update gifting config","description":"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.","externalDocs":{"url":"https://docs.fourthwall.com/api-reference/platform/gifting/update-gifting-config"},"operationId":"update-gifting-config","requestBody":"543c7a53-4866-4675-9715-ab9f1e1416ac","responses":{"200":"7ac7a432-facc-4860-af07-375a6cf57c86"},"security":["103e686c-4948-4951-a2ac-31e5d3790be0","82352bfc-39bc-42f7-968a-f00b4730410b"],"method":"put","type":"path","servers":["40be5880-fbab-413a-be66-974b74f89173"],"path":"/open-api/v1.0/gifting/config","baseUrlOptions":["https://api.fourthwall.com"],"title":"Update gifting config","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.enabled":true,"body.entryTimeLimitSeconds":123,"body.shipping.oneOf.0.type":"ALL_CREATOR","body.products.oneOf.0.type":"ALL"}]},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"The gifting rules to save.","properties":{"enabled":{"type":"boolean","description":"Master flag. Off pauses purchasability without losing the rest.","isRequired":true,"uniqueKey":"enabled","typeLabel":"boolean"},"entryTimeLimitSeconds":{"type":"integer","format":"int32","description":"Entry time limit in seconds. Validated 20-180.","isRequired":true,"uniqueKey":"entryTimeLimitSeconds","typeLabel":"integer\u003cint32>"},"shipping":{"oneOf":[{"type":"object","title":"All Creator","required":["type"],"properties":{"type":{"type":"string","const":"ALL_CREATOR","isRequired":true,"uniqueKey":"shipping.oneOf.0.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.0","typeLabel":"All Creator · object"},{"type":"object","title":"All Creator","required":["type"],"properties":{"type":{"type":"string","const":"ALL_CREATOR","isRequired":true,"uniqueKey":"shipping.oneOf.1.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.1","typeLabel":"All Creator · object"},{"type":"object","title":"All Creator","required":["type","max"],"properties":{"max":{"type":"number","format":"double","isRequired":true,"uniqueKey":"shipping.oneOf.2.max","typeLabel":"number\u003cdouble>"},"type":{"type":"string","const":"ALL_CREATOR","isRequired":true,"uniqueKey":"shipping.oneOf.2.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.2","typeLabel":"All Creator · object"},{"type":"object","title":"All Winner","properties":{"type":{"type":"string","const":"ALL_WINNER","uniqueKey":"shipping.oneOf.3.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.3","typeLabel":"All Winner · object"},{"type":"object","title":"Max Creator","required":["max"],"properties":{"max":{"type":"number","format":"double","isRequired":true,"uniqueKey":"shipping.oneOf.4.max","typeLabel":"number\u003cdouble>"},"type":{"type":"string","const":"MAX_CREATOR","uniqueKey":"shipping.oneOf.4.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.4","typeLabel":"Max Creator · object"}],"isRequired":true,"uniqueKey":"shipping","typeLabel":"All Creator · object · All Creator · object · All Creator · object · All Winner · object · Max Creator · object"},"products":{"oneOf":[{"type":"object","title":"All Products","required":["type"],"properties":{"type":{"type":"string","const":"ALL","isRequired":true,"uniqueKey":"products.oneOf.0.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.0","typeLabel":"All Products · object"},{"type":"object","title":"All Products","required":["type","offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.1.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.1.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"ALL","isRequired":true,"uniqueKey":"products.oneOf.1.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.1","typeLabel":"All Products · object"},{"type":"object","title":"All Products","required":["type","offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.2.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.2.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"ALL","isRequired":true,"uniqueKey":"products.oneOf.2.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.2","typeLabel":"All Products · object"},{"type":"object","title":"Excluded Products","required":["offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.3.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.3.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"EXCLUDED","uniqueKey":"products.oneOf.3.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.3","typeLabel":"Excluded Products · object"},{"type":"object","title":"Selected Products","required":["offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.4.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.4.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"SELECTED","uniqueKey":"products.oneOf.4.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.4","typeLabel":"Selected Products · object"}],"isRequired":true,"uniqueKey":"products","typeLabel":"All Products · object · All Products · object · All Products · object · Excluded Products · object · Selected Products · object"}},"required":["enabled","entryTimeLimitSeconds","products","shipping"],"title":"Update Gifting Config X Request","uniqueKey":"","typeLabel":"Update Gifting Config X Request · object"},"examples":{"Example":{"title":"Example","value":{"enabled":true,"entryTimeLimitSeconds":123,"shipping":{"type":"ALL_CREATOR"},"products":{"type":"ALL"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"7ac7a432-facc-4860-af07-375a6cf57c86":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"A shop's saved gifting rules.","properties":{"enabled":{"type":"boolean","description":"Master \"gift while live\" flag.","isRequired":true,"uniqueKey":"enabled","typeLabel":"boolean"},"entryTimeLimitSeconds":{"type":"integer","format":"int32","description":"Entry time limit in seconds (20-180), maps to the giveaway duration.","isRequired":true,"uniqueKey":"entryTimeLimitSeconds","typeLabel":"integer\u003cint32>"},"shipping":{"oneOf":[{"type":"object","title":"All Creator","required":["type"],"properties":{"type":{"type":"string","const":"ALL_CREATOR","isRequired":true,"uniqueKey":"shipping.oneOf.0.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.0","typeLabel":"All Creator · object"},{"type":"object","title":"All Creator","required":["type"],"properties":{"type":{"type":"string","const":"ALL_CREATOR","isRequired":true,"uniqueKey":"shipping.oneOf.1.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.1","typeLabel":"All Creator · object"},{"type":"object","title":"All Creator","required":["type","max"],"properties":{"max":{"type":"number","format":"double","isRequired":true,"uniqueKey":"shipping.oneOf.2.max","typeLabel":"number\u003cdouble>"},"type":{"type":"string","const":"ALL_CREATOR","isRequired":true,"uniqueKey":"shipping.oneOf.2.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.2","typeLabel":"All Creator · object"},{"type":"object","title":"All Winner","properties":{"type":{"type":"string","const":"ALL_WINNER","uniqueKey":"shipping.oneOf.3.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.3","typeLabel":"All Winner · object"},{"type":"object","title":"Max Creator","required":["max"],"properties":{"max":{"type":"number","format":"double","isRequired":true,"uniqueKey":"shipping.oneOf.4.max","typeLabel":"number\u003cdouble>"},"type":{"type":"string","const":"MAX_CREATOR","uniqueKey":"shipping.oneOf.4.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipping.oneOf.4","typeLabel":"Max Creator · object"}],"isRequired":true,"uniqueKey":"shipping","typeLabel":"All Creator · object · All Creator · object · All Creator · object · All Winner · object · Max Creator · object"},"products":{"oneOf":[{"type":"object","title":"All Products","required":["type"],"properties":{"type":{"type":"string","const":"ALL","isRequired":true,"uniqueKey":"products.oneOf.0.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.0","typeLabel":"All Products · object"},{"type":"object","title":"All Products","required":["type","offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.1.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.1.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"ALL","isRequired":true,"uniqueKey":"products.oneOf.1.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.1","typeLabel":"All Products · object"},{"type":"object","title":"All Products","required":["type","offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.2.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.2.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"ALL","isRequired":true,"uniqueKey":"products.oneOf.2.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.2","typeLabel":"All Products · object"},{"type":"object","title":"Excluded Products","required":["offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.3.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.3.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"EXCLUDED","uniqueKey":"products.oneOf.3.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.3","typeLabel":"Excluded Products · object"},{"type":"object","title":"Selected Products","required":["offerIds"],"properties":{"offerIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"products.oneOf.4.offerIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"products.oneOf.4.offerIds","typeLabel":"string\u003cuuid>[]"},"type":{"type":"string","const":"SELECTED","uniqueKey":"products.oneOf.4.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"products.oneOf.4","typeLabel":"Selected Products · object"}],"isRequired":true,"uniqueKey":"products","typeLabel":"All Products · object · All Products · object · All Products · object · Excluded Products · object · Selected Products · object"},"platform":{"type":"string","description":"Current giveaway platform owning the shop's single gifting slot. Read-only conflict signal — TWITCH or STREAMELEMENTS means another integration owns the slot. A Kick shop operates on the OPEN_API slot.","enum":["TWITCH","STREAMELEMENTS","OPEN_API","NOT_SELECTED"],"isRequired":true,"uniqueKey":"platform","typeLabel":"enum\u003cstring>"}},"required":["enabled","entryTimeLimitSeconds","platform","products","shipping"],"title":"Gifting Config X Response","uniqueKey":"","typeLabel":"Gifting Config X Response · object"},"examples":{"Example":{"title":"Example","value":{"enabled":true,"entryTimeLimitSeconds":123,"shipping":{"type":"ALL_CREATOR"},"products":{"type":"ALL"},"platform":"TWITCH"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"103e686c-4948-4951-a2ac-31e5d3790be0":{"oauth":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth","scopes":{"donation_read":"donation_read","order_read":"order_read","order_write":"order_write","fulfillment_write":"fulfillment_write","giveaway_read":"giveaway_read","giveaway_write":"giveaway_write","memberships_read":"memberships_read","memberships_write":"memberships_write","promotions_write":"promotions_write","promotions_read":"promotions_read","offer_read":"offer_read","offer_write":"offer_write","shop_read":"shop_read","thankyou_read":"thankyou_read","thankyou_write":"thankyou_write","webhook_read":"webhook_read","webhook_write":"webhook_write","media_read":"media_read","media_write":"media_write","analytics_read":"analytics_read","samples_read":"samples_read","samples_write":"samples_write","dns_read":"dns_read","dns_write":"dns_write","settings_read":"settings_read","payout_read":"payout_read","integrations_read":"integrations_read"}}},"scopes":["giveaway_write"]}},"82352bfc-39bc-42f7-968a-f00b4730410b":{"basicAuth":{"type":"http","scheme":"basic","scopes":[]}}},"servers":{"40be5880-fbab-413a-be66-974b74f89173":{"url":"https://api.fourthwall.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth","scopes":{"donation_read":"donation_read","order_read":"order_read","order_write":"order_write","fulfillment_write":"fulfillment_write","giveaway_read":"giveaway_read","giveaway_write":"giveaway_write","memberships_read":"memberships_read","memberships_write":"memberships_write","promotions_write":"promotions_write","promotions_read":"promotions_read","offer_read":"offer_read","offer_write":"offer_write","shop_read":"shop_read","thankyou_read":"thankyou_read","thankyou_write":"thankyou_write","webhook_read":"webhook_read","webhook_write":"webhook_write","media_read":"media_read","media_write":"media_write","analytics_read":"analytics_read","samples_read":"samples_read","samples_write":"samples_write","dns_read":"dns_read","dns_write":"dns_write","settings_read":"settings_read","payout_read":"payout_read","integrations_read":"integrations_read"}}},"scopes":["giveaway_write"]},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth","name":"Authorization"}],"title":"oauth"},{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[]},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"openapi/platform.json"},"subdomain":"fourthwall","siteName":"Fourthwall Developer Docs","title":"Update gifting config - Fourthwall Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-03T13:33:28.022Z","originalFileLocation":"api-reference/platform/gifting/update-gifting-config.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fourthwall Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update gifting config - Fourthwall Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fourthwall Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fourthwall.com/api-reference/platform/gifting/update-gifting-config\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fourthwall.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Update+gifting+config\u0026amp;description=Writes+the+four+creator-controlled+gifting+rule+fields.+Validation+%28duration+20-180s%2C+valid+shipping%2Fproducts%29+and+the+one-platform-per-shop+mutex+are+enforced+\u0026amp;theme=d10057e5a1248fc4c9670d48\u0026amp;signature=2d49add84636f50fb2951b5246b017cfed5dd6a03c59a5ad40d6057824881d53\">\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=\"Update gifting config - Fourthwall Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fourthwall.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Update+gifting+config\u0026amp;description=Writes+the+four+creator-controlled+gifting+rule+fields.+Validation+%28duration+20-180s%2C+valid+shipping%2Fproducts%29+and+the+one-platform-per-shop+mutex+are+enforced+\u0026amp;theme=d10057e5a1248fc4c9670d48\u0026amp;signature=2d49add84636f50fb2951b5246b017cfed5dd6a03c59a5ad40d6057824881d53\">\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/fourthwall/t-Pr9lNT9Pm8i5rs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fourthwall Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fourthwall.com/api-reference/platform/gifting/update-gifting-config\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/platform/gifting/update-gifting-config.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fourthwall Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fourthwall Developer Docs","nav":{"global":{"anchors":[{"anchor":"Fourthwall","icon":"globe","href":"https://fourthwall.com"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/kc6P68z3Uz"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":""}]},{"group":"API","pages":[{"title":"Platform API Overview","href":"/guides/overview"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/guides/authentication"},{"title":"Rate Limiting","href":"/guides/rate-limiting"}]},{"group":"Products","tag":"Beta","pages":[{"title":"Create digital products","href":"/guides/create-digital-products"},{"title":"Create design products","href":"/guides/create-design-products"}]},{"group":"Webhooks","pages":[{"title":"Getting Started with Webhooks","href":"/webhooks/getting-started"},{"title":"Managing Webhooks via API","href":"/webhooks/api-management"},{"title":"Webhook Model","href":"/webhooks/webhook-model"},{"title":"Webhook Event Types","href":"/webhooks/event-types"},{"title":"Signature Verification","href":"/webhooks/signature-verification"},{"title":"Testing Webhooks","href":"/webhooks/testing"},{"title":"Retry Policies","href":"/webhooks/retry-policies"},{"title":"Gifting Guide","href":"/webhooks/gifting-guide"},{"title":"Limitations","href":"/webhooks/limitations"}]},{"group":"Streaming","pages":[{"title":"Alerts","href":"/streaming/alerts"}]},{"group":"Storefront","pages":[{"title":"Storefront API Overview","href":"/storefront/overview"},{"title":"Getting Started","href":"/storefront/getting-started"},{"title":"Fetching Products","href":"/storefront/products"},{"title":"Collection Handles","href":"/storefront/collection"},{"title":"Checkout Setup","href":"/storefront/checkout"},{"title":"Building a Cart \u0026 Checkout","href":"/storefront/cart-checkout-tutorial"},{"title":"Architecture","href":"/storefront/architecture"}]},{"group":"Shop APIs","pages":[{"title":"Cart Checkout Endpoint","href":"/shop-apis/cart-checkout-endpoint"},{"title":"Shop Feeds","href":"/shop-apis/shop-feeds"}]},{"group":"Apps","pages":[{"title":"Getting Started","href":"/apps/getting-started"},{"title":"OAuth Authentication","href":"/guides/oauth"},{"title":"App Sections","href":"/apps/app-sections"},{"title":"Embedded Settings","href":"/apps/embedded-settings"},{"title":"Publishing Your App","href":"/apps/publishing"}]},{"group":"Channel API","tag":"Beta","pages":[{"title":"Channel API Integration Guide","href":"/channel/integration-guide"},{"title":"Platform integration","href":"/channel-api/platform-integration"},{"title":"Agency integration","href":"/channel-api/agency-integration"}]},{"group":"Embedded Sections","pages":[{"title":"Embedded Sections","href":"/embedded-sections/overview"},{"title":"Messages","href":"/embedded-sections/messages"},{"title":"Signature Verification","href":"/embedded-sections/signature"}]},{"group":"HTML Sections","pages":[{"title":"Custom Code Sections","href":"/html/overview"},{"title":"Section Structure","href":"/html/section-structure"},{"group":"Objects","pages":[{"title":"Available Objects","href":"/html/objects/overview"},{"title":"collection","href":"/html/objects/collection"},{"title":"product","href":"/html/objects/product"},{"title":"membership_tiers","href":"/html/objects/membership-tiers"}]},{"group":"Filters","pages":[{"title":"Filters","href":"/html/filters/overview"},{"title":"Money Filters","href":"/html/filters/money"},{"title":"URL Filters","href":"/html/filters/url"},{"title":"Image Filters","href":"/html/filters/image"},{"title":"Array \u0026 String Filters","href":"/html/filters/array-string"},{"title":"Utility Filters","href":"/html/filters/utility"},{"title":"Standard Liquid Filters","href":"/html/filters/standard"}]},{"title":"Examples","href":"/html/examples"}]},{"group":"AI","pages":[{"title":"LLM Support","href":"/ai/llm-support"},{"title":"MCP Server","href":"/ai/mcp"},{"title":"ChatGPT \u0026 Claude App","href":"/ai/ai-app"}]},{"group":"Resources","pages":[{"title":"Changelog","href":"/guides/changelog"},{"title":"Community","href":"/resources/community"},{"title":"Storefront Showcase","href":"/resources/showcase"}]}]},{"tab":"Platform API","groups":[{"group":"Shop","pages":[{"title":"Get Current Shop","openapi":"GET /open-api/v1.0/shops/current","href":"/api-reference/platform/shop/get-current-shop"},{"title":"Get Shop Contact Info","openapi":"GET /open-api/v1.0/shops/current/contact-info","href":"/api-reference/platform/shop/get-shop-contact-info"},{"title":"Get or Create Public Token","openapi":"PUT /open-api/v1.0/public-token","href":"/api-reference/platform/shop/get-public-token"}]},{"group":"Products","pages":[{"title":"List Products","openapi":"GET /open-api/v1.0/products","href":"/api-reference/platform/products/list-products"},{"title":"Create a product","openapi":"POST /open-api/v1.0/products","href":"/api-reference/platform/products/create-product"},{"title":"Get Product","openapi":"GET /open-api/v1.0/products/{productId}","href":"/api-reference/platform/products/get-product"},{"title":"Get Product Inventory","openapi":"GET /open-api/v1.0/products/{productId}/inventory","href":"/api-reference/platform/products/get-product-inventory"},{"title":"Update Product Availability","openapi":"PUT /open-api/v1.0/products/{productId}/availability","href":"/api-reference/platform/products/update-product-availability"},{"title":"Update product (offer) lifecycle state","openapi":"PUT /open-api/v1.0/products/{productId}/state","href":"/api-reference/platform/products-(offers)/update-product-state"},{"title":"Archive a product (offer)","openapi":"DELETE /open-api/v1.0/products/{productId}","href":"/api-reference/platform/products-(offers)/archive-product"}]},{"group":"Product Templates","pages":[{"title":"List product templates (specific page)","openapi":"GET /open-api/v1.0/product-templates/page/{page}","href":"/api-reference/platform/product-templates/list-product-templates-paged"},{"title":"Get product template details","openapi":"GET /open-api/v1.0/product-templates/{productId}","href":"/api-reference/platform/product-templates/get-product-template"}]},{"group":"Customization","pages":[{"title":"Create a new customization","openapi":"POST /open-api/v1.0/customizations","href":"/api-reference/platform/customization/create-customization"}]},{"group":"Media library","pages":[{"title":"List media library images","openapi":"GET /open-api/v1.0/media/images","href":"/api-reference/platform/media-library/list-media-images"},{"title":"Request a pre-signed upload URL","openapi":"POST /open-api/v1.0/media/upload-url","href":"/api-reference/platform/media-library/request-media-upload-url"},{"title":"Save an uploaded image to the media library","openapi":"POST /open-api/v1.0/media/images","href":"/api-reference/platform/media-library/save-media-image"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /open-api/v1.0/order","href":"/api-reference/platform/orders/list-orders"},{"title":"Get Order","openapi":"GET /open-api/v1.0/order/{orderId}","href":"/api-reference/platform/orders/get-order"},{"title":"Get Order by Friendly ID","openapi":"GET /open-api/v1.0/order/by-friendly-id/{friendlyId}","href":"/api-reference/platform/orders/get-order-by-friendly-id"},{"title":"Mark Digital Download Complete","openapi":"PUT /open-api/v1.0/order/{orderId}/downloaded","href":"/api-reference/platform/orders/mark-download-complete"}]},{"group":"Fulfillment","pages":[{"title":"Create Fulfillment","openapi":"POST /open-api/v1.0/fulfillments","href":"/api-reference/platform/fulfillment/create-fulfillment"}]},{"group":"Webhooks","pages":[{"title":"List Webhooks","openapi":"GET /open-api/v1.0/webhooks","href":"/api-reference/platform/webhooks/list-webhooks"},{"title":"Create Webhook","openapi":"POST /open-api/v1.0/webhooks","href":"/api-reference/platform/webhooks/create-webhook"},{"title":"Get Webhook","openapi":"GET /open-api/v1.0/webhooks/{webhookConfigurationId}","href":"/api-reference/platform/webhooks/get-webhook"},{"title":"Update Webhook","openapi":"PUT /open-api/v1.0/webhooks/{webhookConfigurationId}","href":"/api-reference/platform/webhooks/update-webhook"},{"title":"Delete Webhook","openapi":"DELETE /open-api/v1.0/webhooks/{webhookConfigurationId}","href":"/api-reference/platform/webhooks/delete-webhook"},{"title":"List Webhook Events","openapi":"GET /open-api/v1.0/webhook-events","href":"/api-reference/platform/webhooks/list-webhook-events"},{"title":"Get Webhook Event","openapi":"GET /open-api/v1.0/webhook-events/{webhookEventId}","href":"/api-reference/platform/webhooks/get-webhook-event"}]},{"group":"Promotions","pages":[{"title":"List Promotions","openapi":"GET /open-api/v1.0/promotions","href":"/api-reference/platform/promotions/list-promotions"},{"title":"Create Promotion","openapi":"POST /open-api/v1.0/promotions","href":"/api-reference/platform/promotions/create-promotion"},{"title":"Get Promotion","openapi":"GET /open-api/v1.0/promotions/{promotionId}","href":"/api-reference/platform/promotions/get-promotion"}]},{"group":"Memberships","pages":[{"title":"List Membership Tiers","openapi":"GET /open-api/v1.0/memberships/tiers","href":"/api-reference/platform/memberships/list-tiers"},{"title":"List Members","openapi":"GET /open-api/v1.0/memberships/members","href":"/api-reference/platform/memberships/list-members"},{"title":"Get Member","openapi":"GET /open-api/v1.0/memberships/members/{id}","href":"/api-reference/platform/memberships/get-member"}]},{"group":"Donations","pages":[{"title":"List Donations","openapi":"GET /open-api/v1.0/donations","href":"/api-reference/platform/donations/list-donations"},{"title":"Get Donation","openapi":"GET /open-api/v1.0/donations/{donationId}","href":"/api-reference/platform/donations/get-donation"}]},{"group":"Mailing Lists","pages":[{"title":"List Mailing List Entries","openapi":"GET /open-api/v1.0/mailing-list-entries","href":"/api-reference/platform/mailing-lists/list-entries"}]},{"group":"Streaming","pages":[{"title":"Get Streaming Status","openapi":"GET /open-api/v1.0/streaming","href":"/api-reference/platform/streaming/get-streaming-status"},{"title":"Start Streaming","openapi":"PUT /open-api/v1.0/streaming/start","href":"/api-reference/platform/streaming/start-streaming"},{"title":"End Streaming","openapi":"PUT /open-api/v1.0/streaming/end","href":"/api-reference/platform/streaming/end-streaming"}]},{"group":"Gifting","pages":[{"title":"Get Draw","openapi":"GET /open-api/v1.0/gifting/draw/{id}","href":"/api-reference/platform/gifting/get-draw"},{"title":"Finish Draw","openapi":"PUT /open-api/v1.0/gifting/draw/{id}/finish","href":"/api-reference/platform/gifting/finish-draw"},{"title":"Get Gift Purchase","openapi":"GET /open-api/v1.0/gift-purchase/{giftPurchaseId}","href":"/api-reference/platform/gift-purchases/get-gift-purchase"}]},{"group":"Giveaway Links","pages":[{"title":"List Giveaway Packages","openapi":"GET /open-api/v1.0/giveaway-links/packages","href":"/api-reference/platform/giveaway-links/list-packages"},{"title":"Get Giveaway Package","openapi":"GET /open-api/v1.0/giveaway-links/packages/{packageId}","href":"/api-reference/platform/giveaway-links/get-package"},{"title":"Create Giveaway Links","openapi":"POST /open-api/v1.0/giveaway-links","href":"/api-reference/platform/giveaway-links/create-giveaway-links"}]},{"group":"Collections","pages":[{"title":"List Collections","openapi":"GET /open-api/v1.0/collections","href":"/api-reference/platform/collections/list-collections"},{"title":"Create a new collection","openapi":"POST /open-api/v1.0/collections","href":"/api-reference/platform/collections/create-collection"},{"title":"Get collection by ID or slug","openapi":"GET /open-api/v1.0/collections/{collectionIdOrSlug}","href":"/api-reference/platform/collections/get-collection"},{"title":"Get products in a collection","openapi":"GET /open-api/v1.0/collections/{collectionId}/products","href":"/api-reference/platform/collections/get-collection-products"},{"title":"Update a collection","openapi":"PUT /open-api/v1.0/collections/{collectionId}","href":"/api-reference/platform/collections/update-collection"},{"title":"Update collection availability","openapi":"PUT /open-api/v1.0/collections/{collectionId}/availability","href":"/api-reference/platform/collections/update-collection-availability"},{"title":"Set collection products","openapi":"PUT /open-api/v1.0/collections/{collectionId}/products","href":"/api-reference/platform/collections/update-collection-products"}]},{"group":"Thank Yous","pages":[{"title":"Get Thank You","openapi":"GET /open-api/v1.0/thank-yous/{thankYouId}","href":"/api-reference/platform/thank-yous/get-thank-you"},{"title":"List Contributions Awaiting Thank You","openapi":"GET /open-api/v1.0/thank-you-contributions","href":"/api-reference/platform/thank-yous/list-contributions"},{"title":"Create Thank You","openapi":"POST /open-api/v1.0/thank-you-contributions/{id}","href":"/api-reference/platform/thank-yous/create-thank-you"}]},{"group":"Platform Token","pages":[{"title":"Exchange Token","openapi":"POST /open-api/v1.0/platform/token","href":"/api-reference/platform/platform-token/exchange-token"}]},{"group":"Webhook Events","pages":[{"title":"Order placed","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook ORDER_PLACED","href":"/api-reference/order-events/order-placed"},{"title":"Order updated","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook ORDER_UPDATED","href":"/api-reference/order-events/order-updated"},{"title":"Gift purchase","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook GIFT_PURCHASE","href":"/api-reference/order-events/gift-purchase"},{"title":"Product created","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook PRODUCT_CREATED","href":"/api-reference/product-events/product-created"},{"title":"Product updated","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook PRODUCT_UPDATED","href":"/api-reference/product-events/product-updated"},{"title":"Donation","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook DONATION","href":"/api-reference/order-events/donation"},{"title":"Subscription purchased","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook SUBSCRIPTION_PURCHASED","href":"/api-reference/membership-events/subscription-purchased"},{"title":"Subscription expired","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook SUBSCRIPTION_EXPIRED","href":"/api-reference/membership-events/subscription-expired"},{"title":"Subscription changed","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook SUBSCRIPTION_CHANGED","href":"/api-reference/membership-events/subscription-changed"},{"title":"Newsletter subscribed","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook NEWSLETTER_SUBSCRIBED","href":"/api-reference/newsletter-events/newsletter-subscribed"},{"title":"Thank you sent","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook THANK_YOU_SENT","href":"/api-reference/thank-you-events/thank-you-sent"},{"title":"Gift draw started","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook GIFT_DRAW_STARTED","href":"/api-reference/giveaway-events/gift-draw-started"},{"title":"Gift draw ended","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook GIFT_DRAW_ENDED","href":"/api-reference/giveaway-events/gift-draw-ended"},{"title":"Promotion created","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook PROMOTION_CREATED","href":"/api-reference/promotion-events/promotion-created"},{"title":"Promotion updated","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook PROMOTION_UPDATED","href":"/api-reference/promotion-events/promotion-updated"},{"title":"Promotion status changed","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook PROMOTION_STATUS_CHANGED","href":"/api-reference/promotion-events/promotion-status-changed"},{"title":"Platform app disconnected","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook PLATFORM_APP_DISCONNECTED","href":"/api-reference/platform-events/platform-app-disconnected"},{"title":"Collection updated","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook COLLECTION_UPDATED","href":"/api-reference/collection-events/collection-updated"},{"title":"Cart abandoned 1 hour","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook CART_ABANDONED_1H","href":"/api-reference/cart-events/cart-abandoned-1-hour"},{"title":"Cart abandoned 24 hours","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook CART_ABANDONED_24H","href":"/api-reference/cart-events/cart-abandoned-24-hours"},{"title":"Cart abandoned 72 hours","version":null,"deprecated":null,"openapi":"/openapi/platform.json webhook CART_ABANDONED_72H","href":"/api-reference/cart-events/cart-abandoned-72-hours"}]}]},{"tab":"Storefront API","groups":[{"group":"Shop","pages":[{"title":"Get Shop Information","openapi":"openapi/storefront.json GET /v1/shop","href":"/api-reference/storefront/shop/get-shop"}]},{"group":"Products","pages":[{"title":"Get Product by Slug","openapi":"openapi/storefront.json GET /v1/products/{slug}","href":"/api-reference/storefront/products/get-product"}]},{"group":"Collections","pages":[{"title":"List Collections","openapi":"openapi/storefront.json GET /v1/collections","href":"/api-reference/storefront/collections/list-collections"},{"title":"Get Collection","openapi":"openapi/storefront.json GET /v1/collections/{slug}","href":"/api-reference/storefront/collections/get-collection"},{"title":"Get Collection Products","openapi":"openapi/storefront.json GET /v1/collections/{slug}/products","href":"/api-reference/storefront/collections/get-collection-products"}]},{"group":"Carts","pages":[{"title":"Create Cart","openapi":"openapi/storefront.json POST /v1/carts","href":"/api-reference/storefront/carts/create-cart"},{"title":"Get Cart","openapi":"openapi/storefront.json GET /v1/carts/{cartId}","href":"/api-reference/storefront/carts/get-cart"},{"title":"Add to Cart","openapi":"openapi/storefront.json POST /v1/carts/{cartId}/add","href":"/api-reference/storefront/carts/add-to-cart"},{"title":"Remove from Cart","openapi":"openapi/storefront.json POST /v1/carts/{cartId}/remove","href":"/api-reference/storefront/carts/remove-from-cart"},{"title":"Change Cart Quantity","openapi":"openapi/storefront.json POST /v1/carts/{cartId}/change","href":"/api-reference/storefront/carts/change-cart-quantity"}]}]},{"tab":"Memberships API","hidden":false,"groups":[{"group":"Get Started","pages":[{"title":"Working with Images","href":"/api-reference/membership/getting-started-images"}]},{"group":"Posts","pages":[{"title":"List Posts","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/posts","href":"/api-reference/membership/posts/list-posts"},{"title":"Get Post","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/posts/{id}","href":"/api-reference/membership/posts/get-post"},{"title":"Delete Post","openapi":"openapi/membership.json DELETE /open-api/v1.1/memberships/posts/{id}","href":"/api-reference/membership/posts/delete-post"},{"title":"Create Audio Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/audios","href":"/api-reference/membership/posts/create-audio-post"},{"title":"Create Image Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/images","href":"/api-reference/membership/posts/create-image-post"},{"title":"Update Image Post","openapi":"openapi/membership.json PUT /open-api/v1.1/memberships/posts/images/{id}","href":"/api-reference/membership/posts/update-image-post"},{"title":"Create Text Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/texts","href":"/api-reference/membership/posts/create-text-post"},{"title":"Update Text Post","openapi":"openapi/membership.json PUT /open-api/v1.1/memberships/posts/texts/{id}","href":"/api-reference/membership/posts/update-text-post"},{"title":"Create Video Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/videos","href":"/api-reference/membership/posts/create-video-post"},{"title":"Create Video Embed Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/video_embeds","href":"/api-reference/membership/posts/create-video-embed-post"},{"title":"Update Video Embed Post","openapi":"openapi/membership.json PUT /open-api/v1.1/memberships/posts/video_embeds/{id}","href":"/api-reference/membership/posts/update-video-embed-post"},{"title":"Create Poll Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/polls","href":"/api-reference/membership/posts/create-poll-post"},{"title":"Update Poll Post","openapi":"openapi/membership.json PUT /open-api/v1.1/memberships/posts/polls/{id}","href":"/api-reference/membership/posts/update-poll-post"},{"title":"Pin Post","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/posts/{post_id}/pin","href":"/api-reference/membership/posts/pin-post"},{"title":"Unpin Post","openapi":"openapi/membership.json DELETE /open-api/v1.1/memberships/posts/{post_id}/pin","href":"/api-reference/membership/posts/unpin-post"}]},{"group":"Members","pages":[{"title":"List Members","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/members","href":"/api-reference/membership/members/list-members"},{"title":"Get Member","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/members/{id}","href":"/api-reference/membership/members/get-member"}]},{"group":"Tags","pages":[{"title":"List Post Tags","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/tags/posts","href":"/api-reference/membership/tags/list-post-tags"},{"title":"Create Post Tag","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/tags/posts","href":"/api-reference/membership/tags/create-post-tag"},{"title":"Get Post Tag","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/tags/posts/{id}","href":"/api-reference/membership/tags/get-post-tag"},{"title":"Update Post Tag","openapi":"openapi/membership.json PATCH /open-api/v1.1/memberships/tags/posts/{id}","href":"/api-reference/membership/tags/update-post-tag"},{"title":"Delete Post Tag","openapi":"openapi/membership.json DELETE /open-api/v1.1/memberships/tags/posts/{id}","href":"/api-reference/membership/tags/delete-post-tag"}]},{"group":"Series","pages":[{"title":"List Post Series","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/series/posts","href":"/api-reference/membership/series/list-post-series"},{"title":"Create Post Series","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/series/posts","href":"/api-reference/membership/series/create-post-series"},{"title":"Get Post Series","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/series/posts/{id}","href":"/api-reference/membership/series/get-post-series"},{"title":"Update Post Series","openapi":"openapi/membership.json PUT /open-api/v1.1/memberships/series/posts/{id}","href":"/api-reference/membership/series/update-post-series"},{"title":"Delete Post Series","openapi":"openapi/membership.json DELETE /open-api/v1.1/memberships/series/posts/{id}","href":"/api-reference/membership/series/delete-post-series"}]},{"group":"Tiers","pages":[{"title":"List Tiers","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/tiers","href":"/api-reference/membership/tiers/list-tiers"},{"title":"Create Tier","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/tiers","href":"/api-reference/membership/tiers/create-tier"},{"title":"Get Tier","openapi":"openapi/membership.json GET /open-api/v1.1/memberships/tiers/{id}","href":"/api-reference/membership/tiers/get-tier"},{"title":"Update Tier","openapi":"openapi/membership.json PATCH /open-api/v1.1/memberships/tiers/{id}","href":"/api-reference/membership/tiers/update-tier"}]},{"group":"Resources","pages":[{"title":"Create Image","openapi":"openapi/membership.json POST /open-api/v1.1/memberships/images","href":"/api-reference/membership/resources/create-image"},{"title":"Confirm Image Upload","openapi":"openapi/membership.json PATCH /open-api/v1.1/memberships/images/{id}/confirm","href":"/api-reference/membership/resources/confirm-post"}]}]},{"tab":"Channel API","groups":[{"group":"Get Started","pages":[{"title":"Authentication","href":"/channel-api/authentication"}]},{"group":"Channel","pages":[{"title":"Get current channel for channel API client","openapi":"openapi/channel-api.json GET /channel-api/v1.0/channel/current","href":"/api-reference/channel-api/channel/get-current-channel"}]},{"group":"Shops","pages":[{"title":"Request a presigned upload URL for artwork","openapi":"openapi/channel-api.json POST /channel-api/v1.0/upload-url","href":"/api-reference/channel-api/shops/request-upload-url"},{"title":"List shops attached to the agency","openapi":"openapi/channel-api.json GET /channel-api/v1.0/shops","href":"/api-reference/channel-api/shops/get-shops"},{"title":"Create a shop","openapi":"openapi/channel-api.json POST /channel-api/v1.0/shops","href":"/api-reference/channel-api/shops/create-shop"}]},{"group":"Media library","pages":[{"title":"Register an uploaded image into the shop's media library","openapi":"openapi/channel-api.json POST /channel-api/v1.0/media/images","href":"/api-reference/channel-api/media-library/register-media-image"}]},{"group":"Previews","pages":[{"title":"Create a preview pipeline for a product","openapi":"openapi/channel-api.json POST /channel-api/v1.0/previews","href":"/api-reference/channel-api/previews/create-preview"}]}]}]},"title":"Update gifting config - Fourthwall Developer Docs","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}