Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs//fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.
POST
/
v1
/
configs
Error
A valid request URL is required to generate request examples
Developer API key. Required for config create/list and project analytics. The disabled config DELETE endpoint also requires authentication. Optional on public GET reads (anonymous callers are IP rate-limited). Obtain from the Developer dashboard.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"donate.gg","colors":{"primary":"#F53BB8","light":"#F53BB8","dark":"#F53BB8"},"logo":{"light":"https://mintcdn.com/donategg/Goxyg0EjtdqKwxva/images/logo/lightmode.svg?fit=max\u0026auto=format\u0026n=Goxyg0EjtdqKwxva\u0026q=85\u0026s=2422a04c054e63ee29ece397fcf7c69f","dark":"https://mintcdn.com/donategg/Goxyg0EjtdqKwxva/images/logo/darkmode.svg?fit=max\u0026auto=format\u0026n=Goxyg0EjtdqKwxva\u0026q=85\u0026s=b730c5ed1d2ab679899381fcc2412858"},"favicon":"https://mintcdn.com/donategg/Goxyg0EjtdqKwxva/favicon.svg?fit=max\u0026auto=format\u0026n=Goxyg0EjtdqKwxva\u0026q=85\u0026s=d86bc7699620d02d3d7213f6e4a0e071","navbar":{"links":[{"href":"mailto:leap@donate.gg","label":"Book a Demo"}],"primary":{"type":"button","label":"Donate","href":"https://donate.gg"}},"footer":{"socials":{"x":"https://x.com/donatedotgg"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Follow us","icon":"x-twitter","href":"https://x.com/donatedotgg"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"donategg","hasAudioNarration":false,"actualSubdomain":"donategg","customDomains":["docs.donate.gg"],"gitSource":{"type":"github","owner":"cherrydevelopmentorg","repo":"daas","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aea707ee98b1b2c02137b1c","collectionId":"eda1ea63-103e-4aea-a47b-f76edc9e9235","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aea707ee98b1b2c02137b1c"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aee299db25928f23c6db6dd","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"Documentation","count":30},{"language":"default","tag":"API","count":14},{"language":"default","tag":"Developer","count":6},{"language":"default","tag":"Charity Tokens","count":3},{"language":"default","tag":"Blockchain","count":3},{"language":"default","tag":"AI \u0026 LLMs","count":2},{"language":"default","tag":"Other","count":2},{"language":"default","tag":"For Non-profits","count":2},{"language":"default","tag":"Getting Started","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-a-config","slug":"/api-reference/create-a-config","pageMetadata":{"title":"Create a config","description":"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi post /v1/configs","href":"/api-reference/create-a-config","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/\", \"/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.\"]\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 a config","description":"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi post /v1/configs","href":"/api-reference/create-a-config","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"v1.configs.create","summary":"Create a config","description":"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.","requestBody":"61b45422-31c7-478b-a21b-a5b6b2820f1e","responses":{"201":"ab941139-0d68-42a6-861d-604be86646dc","400":"e372a5cc-07f4-4348-9606-f78c6d9721a9"},"security":["4d90b0e5-703c-4bde-b3a8-9124078059bc"],"method":"post","type":"path","servers":["737186e8-63a9-4b9a-a8d4-a13bbedccf3f"],"path":"/v1/configs","baseUrlOptions":["/api"],"title":"Create a config","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"charityBeneficiaries":{"type":"array","items":{"type":"object","properties":{"charityId":{"type":"string","isRequired":true,"uniqueKey":"charityBeneficiaries.items.[INDEX].charityId","typeLabel":"string"},"weight":{"type":"number","isRequired":true,"uniqueKey":"charityBeneficiaries.items.[INDEX].weight","typeLabel":"number"}},"required":["charityId","weight"],"uniqueKey":"charityBeneficiaries.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"charityBeneficiaries","typeLabel":"object[]"}},"required":["charityBeneficiaries"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"charityBeneficiaries":[{"charityId":"\u003cstring>","weight":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ab941139-0d68-42a6-861d-604be86646dc":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"object","properties":{"hex":{"type":"string","isRequired":true,"uniqueKey":"id.hex","typeLabel":"string"},"base58":{"type":"string","isRequired":true,"uniqueKey":"id.base58","typeLabel":"string"}},"required":["hex","base58"],"additionalProperties":false,"isRequired":true,"uniqueKey":"id","typeLabel":"object"},"feeBps":{"type":"string","description":"Stored config fee in basis points, retained for historical replay. Use the effective-fee endpoint for current Solana pricing.","isRequired":true,"uniqueKey":"feeBps","typeLabel":"string"},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"users.items.[INDEX].id","typeLabel":"string"},"weight":{"type":"string","isRequired":true,"uniqueKey":"users.items.[INDEX].weight","typeLabel":"string"}},"required":["id","weight"],"additionalProperties":false,"uniqueKey":"users.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"users","typeLabel":"object[]"},"charities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].id","typeLabel":"string"},"slug":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].name","typeLabel":"string"},"logo":{"type":"string","description":"Charity logo URL. Opted-out charities return a Donate placeholder; other statuses retain stored branding.","isRequired":true,"uniqueKey":"charities.items.[INDEX].logo","typeLabel":"string"},"website":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].website","typeLabel":"string"},"mission":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].mission","typeLabel":"string"},"address":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].address","typeLabel":"string"},"city":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].city","typeLabel":"string"},"state":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].state","typeLabel":"string"},"country":{"enum":["US","UK","CA","DE","ES","FR","IE","IT","JP","NL","PT","AR","BR","CL","CO","PE","NZ","NO","AU","LEGACY"],"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].country","typeLabel":"enum\u003cstring>"},"zipCode":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].zipCode","typeLabel":"string"},"taxId":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].taxId","typeLabel":"string"},"status":{"enum":["ACTIVE_ONBOARDED","ACTIVE_NOT_ONBOARDED","ACTIVE_REVIEWING_TERMS","SOFT_HIDDEN","PLATFORM_DISABLED","OPTED_OUT"],"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"configId":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].configId","typeLabel":"string"},"socials":{"type":"object","properties":{"blog":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.blog.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.blog.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.blog","typeLabel":"string | null"},"twitter":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitter.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitter.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitter","typeLabel":"string | null"},"facebook":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebook.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebook.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebook","typeLabel":"string | null"},"instagram":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagram.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagram.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagram","typeLabel":"string | null"},"linkedin":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedin.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedin","typeLabel":"string | null"},"youtube":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtube.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtube.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtube","typeLabel":"string | null"},"blogUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.blogUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.blogUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.blogUrl","typeLabel":"string | null"},"twitterUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitterUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitterUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitterUrl","typeLabel":"string | null"},"twitterHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitterHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitterHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.twitterHandle","typeLabel":"string | null"},"facebookUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebookUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebookUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebookUrl","typeLabel":"string | null"},"facebookHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebookHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebookHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.facebookHandle","typeLabel":"string | null"},"instagramUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagramUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagramUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagramUrl","typeLabel":"string | null"},"instagramHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagramHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagramHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.instagramHandle","typeLabel":"string | null"},"linkedinUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedinUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedinUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedinUrl","typeLabel":"string | null"},"linkedinHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedinHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedinHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.linkedinHandle","typeLabel":"string | null"},"youtubeUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeUrl","typeLabel":"string | null"},"youtubeHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeHandle","typeLabel":"string | null"},"youtubeChannelId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeChannelId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeChannelId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials.youtubeChannelId","typeLabel":"string | null"}},"required":["blog","twitter","facebook","instagram","linkedin","youtube","blogUrl","twitterUrl","twitterHandle","facebookUrl","facebookHandle","instagramUrl","instagramHandle","linkedinUrl","linkedinHandle","youtubeUrl","youtubeHandle","youtubeChannelId"],"additionalProperties":false,"isRequired":true,"uniqueKey":"charities.items.[INDEX].socials","typeLabel":"object"},"isEnabled":{"type":"boolean","isRequired":true,"uniqueKey":"charities.items.[INDEX].isEnabled","typeLabel":"boolean"},"weight":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].weight","typeLabel":"string"},"stats":{"type":"object","properties":{"pendingUsdE6":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.pendingUsdE6","typeLabel":"string"},"finalizedUsdE6":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.finalizedUsdE6","typeLabel":"string"},"displayedUsdE6":{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.displayedUsdE6","typeLabel":"string"},"pendingCount":{"type":"number","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.pendingCount","typeLabel":"number"},"finalizedCount":{"type":"number","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.finalizedCount","typeLabel":"number"},"donationCount":{"type":"number","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.donationCount","typeLabel":"number"},"firstDonationAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.firstDonationAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.firstDonationAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.firstDonationAt","typeLabel":"string | null"},"lastDonationAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.lastDonationAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.lastDonationAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charities.items.[INDEX].stats.lastDonationAt","typeLabel":"string | null"}},"required":["pendingUsdE6","finalizedUsdE6","displayedUsdE6","pendingCount","finalizedCount","donationCount","firstDonationAt","lastDonationAt"],"additionalProperties":false,"uniqueKey":"charities.items.[INDEX].stats","typeLabel":"object"}},"required":["id","slug","name","logo","website","mission","address","city","state","country","zipCode","taxId","status","configId","socials","isEnabled","weight"],"additionalProperties":false,"uniqueKey":"charities.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"charities","typeLabel":"object[]"}},"required":["id","feeBps","users","charities"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":{"hex":"\u003cstring>","base58":"\u003cstring>"},"feeBps":"\u003cstring>","users":[{"id":"\u003cstring>","weight":"\u003cstring>"}],"charities":[{"id":"\u003cstring>","slug":"\u003cstring>","name":"\u003cstring>","logo":"\u003cstring>","website":"\u003cstring>","mission":"\u003cstring>","address":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","country":"US","zipCode":"\u003cstring>","taxId":"\u003cstring>","status":"ACTIVE_ONBOARDED","configId":"\u003cstring>","socials":{"blog":"\u003cstring>","twitter":"\u003cstring>","facebook":"\u003cstring>","instagram":"\u003cstring>","linkedin":"\u003cstring>","youtube":"\u003cstring>","blogUrl":"\u003cstring>","twitterUrl":"\u003cstring>","twitterHandle":"\u003cstring>","facebookUrl":"\u003cstring>","facebookHandle":"\u003cstring>","instagramUrl":"\u003cstring>","instagramHandle":"\u003cstring>","linkedinUrl":"\u003cstring>","linkedinHandle":"\u003cstring>","youtubeUrl":"\u003cstring>","youtubeHandle":"\u003cstring>","youtubeChannelId":"\u003cstring>"},"isEnabled":true,"weight":"\u003cstring>","stats":{"pendingUsdE6":"\u003cstring>","finalizedUsdE6":"\u003cstring>","displayedUsdE6":"\u003cstring>","pendingCount":123,"finalizedCount":123,"donationCount":123,"firstDonationAt":"\u003cstring>","lastDonationAt":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"e372a5cc-07f4-4348-9606-f78c6d9721a9":{"description":"400","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["defined","code","status","message"],"properties":{"defined":{"const":true,"isRequired":true,"uniqueKey":"oneOf.0.defined","typeLabel":"any"},"code":{"const":"VALIDATION_ERROR","isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"any"},"status":{"const":400,"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"any"},"message":{"type":"string","default":"Validation failed","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.data.error","typeLabel":"string"},"code":{"const":"VALIDATION_ERROR","isRequired":true,"uniqueKey":"oneOf.0.data.code","typeLabel":"any"},"issues":{"type":"array","items":{"oneOf":[{},{"type":"null","uniqueKey":"oneOf.0.data.issues.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.issues.items.[INDEX]","typeLabel":"null"},"uniqueKey":"oneOf.0.data.issues","typeLabel":"null[]"}},"required":["error","code"],"additionalProperties":false,"uniqueKey":"oneOf.0.data","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["defined","code","status","message"],"properties":{"defined":{"const":true,"isRequired":true,"uniqueKey":"oneOf.1.defined","typeLabel":"any"},"code":{"const":"CHARITY_NOT_FOUND","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"any"},"status":{"const":400,"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"any"},"message":{"type":"string","default":"One or more charity IDs do not exist","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.data.error","typeLabel":"string"},"code":{"const":"CHARITY_NOT_FOUND","isRequired":true,"uniqueKey":"oneOf.1.data.code","typeLabel":"any"}},"required":["error","code"],"additionalProperties":false,"uniqueKey":"oneOf.1.data","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["defined","code","status","message"],"properties":{"defined":{"const":true,"isRequired":true,"uniqueKey":"oneOf.2.defined","typeLabel":"any"},"code":{"const":"CHARITY_NOT_ACTIVE","isRequired":true,"uniqueKey":"oneOf.2.code","typeLabel":"any"},"status":{"const":400,"isRequired":true,"uniqueKey":"oneOf.2.status","typeLabel":"any"},"message":{"type":"string","default":"New configs require active charity beneficiaries","isRequired":true,"uniqueKey":"oneOf.2.message","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.data.error","typeLabel":"string"},"code":{"const":"CHARITY_NOT_ACTIVE","isRequired":true,"uniqueKey":"oneOf.2.data.code","typeLabel":"any"}},"required":["error","code"],"additionalProperties":false,"uniqueKey":"oneOf.2.data","typeLabel":"object"}},"uniqueKey":"oneOf.2","typeLabel":"object"},{"type":"object","required":["defined","code","status","message"],"properties":{"defined":{"const":true,"isRequired":true,"uniqueKey":"oneOf.3.defined","typeLabel":"any"},"code":{"const":"DUPLICATE_CHARITY_IDS","isRequired":true,"uniqueKey":"oneOf.3.code","typeLabel":"any"},"status":{"const":400,"isRequired":true,"uniqueKey":"oneOf.3.status","typeLabel":"any"},"message":{"type":"string","default":"The same charity appears more than once in charityBeneficiaries","isRequired":true,"uniqueKey":"oneOf.3.message","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.3.data.error","typeLabel":"string"},"code":{"const":"DUPLICATE_CHARITY_IDS","isRequired":true,"uniqueKey":"oneOf.3.data.code","typeLabel":"any"}},"required":["error","code"],"additionalProperties":false,"uniqueKey":"oneOf.3.data","typeLabel":"object"}},"uniqueKey":"oneOf.3","typeLabel":"object"},{"type":"object","required":["defined","code","status","message"],"properties":{"defined":{"const":true,"isRequired":true,"uniqueKey":"oneOf.4.defined","typeLabel":"any"},"code":{"const":"INVALID_JSON","isRequired":true,"uniqueKey":"oneOf.4.code","typeLabel":"any"},"status":{"const":400,"isRequired":true,"uniqueKey":"oneOf.4.status","typeLabel":"any"},"message":{"type":"string","default":"Invalid JSON body","isRequired":true,"uniqueKey":"oneOf.4.message","typeLabel":"string"},"data":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.4.data.error","typeLabel":"string"},"code":{"const":"INVALID_JSON","isRequired":true,"uniqueKey":"oneOf.4.data.code","typeLabel":"any"}},"required":["error","code"],"additionalProperties":false,"uniqueKey":"oneOf.4.data","typeLabel":"object"}},"uniqueKey":"oneOf.4","typeLabel":"object"},{"type":"object","required":["defined","code","status","message"],"properties":{"defined":{"const":false,"isRequired":true,"uniqueKey":"oneOf.5.defined","typeLabel":"any"},"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.5.code","typeLabel":"string"},"status":{"type":"number","isRequired":true,"uniqueKey":"oneOf.5.status","typeLabel":"number"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.5.message","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"oneOf.5.data","typeLabel":"any"}},"uniqueKey":"oneOf.5","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"defined":true,"code":"VALIDATION_ERROR","status":400,"message":"Validation failed","data":{"error":"\u003cstring>","code":"VALIDATION_ERROR","issues":["\u003cunknown>"]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4d90b0e5-703c-4bde-b3a8-9124078059bc":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"donate-api-key","description":"Developer API key. Required for config create/list and project analytics. The disabled config DELETE endpoint also requires authentication. Optional on public GET reads (anonymous callers are IP rate-limited). Obtain from the Developer dashboard.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"737186e8-63a9-4b9a-a8d4-a13bbedccf3f":{"url":"/api","description":"API origin. Version prefixes live on each operation path."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"donate-api-key","description":"Developer API key. Required for config create/list and project analytics. The disabled config DELETE endpoint also requires authentication. Optional on public GET reads (anonymous callers are IP rate-limited). Obtain from the Developer dashboard.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"donate-api-key","type":"string","description":"Developer API key. Required for config create/list and project analytics. The disabled config DELETE endpoint also requires authentication. Optional on public GET reads (anonymous callers are IP rate-limited). Obtain from the Developer dashboard.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"donate-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://api.donate.gg/api/openapi"},"subdomain":"donategg","siteName":"donate.gg","title":"Create a config - donate.gg","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T19:25:36.486Z","originalFileLocation":"api-reference/create-a-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=\"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.\">\u003cmeta data-mint-head name=\"application-name\" content=\"donate.gg\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_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/donategg/J4sBiGsgOVXHLLER/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a config - donate.gg\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"donate.gg\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.donate.gg/api-reference/create-a-config\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://donategg.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Create+a+config\u0026amp;description=Create+a+config+with+active+charity+beneficiaries.+New+configs+reject+hidden%2C+disabled%2C+or+opted-out+beneficiaries+with+CHARITY_NOT_ACTIVE.+Identical+existing+c\u0026amp;theme=aa3652fee4aae0b3db2e1034\u0026amp;signature=5c66928a6c1c0373327d250f9c7f13990d34db7612654d6a97ce7648235a318c\">\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 a config - donate.gg\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://donategg.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Create+a+config\u0026amp;description=Create+a+config+with+active+charity+beneficiaries.+New+configs+reject+hidden%2C+disabled%2C+or+opted-out+beneficiaries+with+CHARITY_NOT_ACTIVE.+Identical+existing+c\u0026amp;theme=aa3652fee4aae0b3db2e1034\u0026amp;signature=5c66928a6c1c0373327d250f9c7f13990d34db7612654d6a97ce7648235a318c\">\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/donategg/J4sBiGsgOVXHLLER/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"donate.gg\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F53BB8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.donate.gg/api-reference/create-a-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/create-a-config.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.donate.gg/#organization\",\"name\":\"donate.gg\",\"url\":\"https://docs.donate.gg\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/donategg/Goxyg0EjtdqKwxva/images/logo/lightmode.svg?fit=max\u0026auto=format\u0026n=Goxyg0EjtdqKwxva\u0026q=85\u0026s=2422a04c054e63ee29ece397fcf7c69f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.donate.gg#website\",\"name\":\"donate.gg\",\"url\":\"https://docs.donate.gg\",\"publisher\":{\"@id\":\"https://docs.donate.gg/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.donate.gg/api-reference/create-a-config#webpage\",\"url\":\"https://docs.donate.gg/api-reference/create-a-config\",\"name\":\"Create a config\",\"description\":\"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.\",\"dateModified\":\"2026-11-06T19:25:36.486Z\",\"isPartOf\":{\"@id\":\"https://docs.donate.gg#website\"},\"breadcrumb\":{\"@id\":\"https://docs.donate.gg/api-reference/create-a-config#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.donate.gg/api-reference/create-a-config#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.donate.gg/api-reference/list-categories\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a config\",\"item\":\"https://docs.donate.gg/api-reference/create-a-config\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.donate.gg/api-reference/create-a-config#apireference\",\"headline\":\"Create a config\",\"name\":\"Create a config\",\"description\":\"Create a config with active charity beneficiaries. New configs reject hidden, disabled, or opted-out beneficiaries with CHARITY_NOT_ACTIVE. Identical existing configs remain retrievable through an idempotent retry, regardless of current beneficiary status. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. The stored config fee is retained for historical replay and ID compatibility. After Solana fee-policy activation, current pricing uses the developer project and original attribution address. Use GET /configs/{configId}/fee for an estimate. Native Solana donations use their donation event slot; bridged EVM donations use their finalized Solana USDC delivery slot, not the source block or later admission slot.\",\"url\":\"https://docs.donate.gg/api-reference/create-a-config\",\"mainEntityOfPage\":{\"@id\":\"https://docs.donate.gg/api-reference/create-a-config#webpage\"},\"dateModified\":\"2026-11-06T19:25:36.486Z\",\"publisher\":{\"@id\":\"https://docs.donate.gg/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.donate.gg#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"donate.gg\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"donate.gg","nav":{"global":{"anchors":[{"anchor":"Follow us","icon":"x-twitter","href":"https://x.com/donatedotgg"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/welcome"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"List categories","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/categories","href":"/api-reference/list-categories"},{"title":"List chains","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/chains","href":"/api-reference/list-chains"},{"title":"List charities","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities","href":"/api-reference/list-charities"},{"title":"Search charities","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities/search","href":"/api-reference/search-charities"},{"title":"Recently listed charities","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities/feed","href":"/api-reference/recently-listed-charities"},{"title":"Recently listed charities (Atom)","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities/feed.atom","href":"/api-reference/recently-listed-charities-atom"},{"title":"Get a charity by id","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities/{charityId}","href":"/api-reference/get-a-charity-by-id"},{"title":"List charity donations received","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities/{charityId}/donations","href":"/api-reference/list-charity-donations-received"},{"title":"List charity donation messages","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charities/{charityId}/donations/messages","href":"/api-reference/list-charity-donation-messages"},{"title":"List charity request registers","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charity-requests/registers","href":"/api-reference/list-charity-request-registers"},{"title":"Search a charity register","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charity-requests/search","href":"/api-reference/search-a-charity-register"},{"title":"Request a charity","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi post /v1/charity-requests","href":"/api-reference/request-a-charity"},{"title":"Get charity request status","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charity-requests/{register}/{registration}","href":"/api-reference/get-charity-request-status"},{"title":"List campaigns","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/campaigns","href":"/api-reference/list-campaigns"},{"title":"Get campaign stats","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/campaigns/{campaignId}/stats","href":"/api-reference/get-campaign-stats"},{"title":"List campaign donations","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/campaigns/{campaignId}/donations","href":"/api-reference/list-campaign-donations"},{"title":"Get or provision campaign donation-echo address","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/campaigns/{campaignId}/donation-echo","href":"/api-reference/get-or-provision-campaign-donation-echo-address"},{"title":"Get current Solana settlement donation fee","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/configs/{configId}/fee","href":"/api-reference/get-current-solana-settlement-donation-fee"},{"title":"List configs","description":"List configs created by the developer (identified by API key). Paginated.","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/configs","href":"/api-reference/list-configs"},{"title":"Create a config","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi post /v1/configs","href":"/api-reference/create-a-config"},{"title":"Get a config by id","description":"Get a config with its user and charity beneficiaries. Public: any caller may inspect a config by id (Core-scoped). API key is optional.","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/configs/{configId}","href":"/api-reference/get-a-config-by-id"},{"title":"Config deletion (disabled)","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi delete /v1/configs/{configId}","href":"/api-reference/config-deletion-disabled"},{"title":"Get config stats by ID","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/configs/{configId}/stats","href":"/api-reference/get-config-stats-by-id"},{"title":"Get config leaderboard by ID","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/configs/{configId}/leaderboard","href":"/api-reference/get-config-leaderboard-by-id"},{"title":"Get a charity token by address","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/{chainId}/tokens/{address}","href":"/api-reference/get-a-charity-token-by-address"},{"title":"Get a charity token stats by address","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/{chainId}/tokens/{address}/stats","href":"/api-reference/get-a-charity-token-stats-by-address"},{"title":"Get charity token leaderboard","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/{chainId}/tokens/leaderboard","href":"/api-reference/get-charity-token-leaderboard"},{"title":"List charity coins","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charity-coins","href":"/api-reference/list-charity-coins"},{"title":"List charity-coin creators","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/charity-coins/creators","href":"/api-reference/list-charity-coin-creators"},{"title":"Get user receiver stats","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/users/{userId}/receiver-stats","href":"/api-reference/get-user-receiver-stats"},{"title":"Get the subject leaderboard for a given donation source contract","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/{chainId}/donationSources/{address}/subjects/leaderboard","href":"/api-reference/get-the-subject-leaderboard-for-a-given-donation-source-contract"},{"title":"Look up bridged donation transfers","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/donation-transfers","href":"/api-reference/look-up-bridged-donation-transfers"},{"title":"List donation activity","deprecated":null,"version":null,"openapi":"https://api.donate.gg/api/openapi get /v1/donation-activity","href":"/api-reference/list-donation-activity"}]}]}]},"basePath":"","title":"Create a config - donate.gg","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}