Forward extra request data to the upstream on a per-paywall basis.
Custom headers and query parameters live on the paywall, not the service. Use them when one specific endpoint needs additional context that the rest of the service doesn’t.
Custom headers
Add a header name and value on the paywall. Proceeds attaches the header to every proxied request before forwarding it to the upstream Target URL.Common uses:
Pinning an upstream API version: Accept-Version: 2026-04-01
Identifying the calling product to a multi-tenant upstream: X-Tenant: weather
Triggering upstream feature flags
Query parameters
Add a parameter name and value on the paywall. Proceeds appends the parameter to the upstream URL.Common uses:
Pinning a model name on an inference API: model=claude-opus-4-7
Forcing a specific data source: source=premium
Locking a region: region=us-east-1
Layering
Headers and params stack on top of upstream auth and the client’s own request:
Proceeds attaches upstream auth (configured at the service level).
Proceeds attaches paywall custom headers and query parameters.
The client’s request body and additional query parameters pass through unchanged.
If the same header name appears on both the paywall and the client request, the client value wins for non-auth headers. Auth headers configured via Forward upstream auth always win — they can’t be overridden by the client.
Use custom headers to pin sensitive defaults that you don’t want clients to override, like an API version or a tenant ID.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Proceeds","description":"Add USDC paywalls to any API. Agents pay per request — no accounts, no API keys, no subscriptions.","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/proceeds/SU359FAuaQ7qg3QM/logo/light.png?fit=max\u0026auto=format\u0026n=SU359FAuaQ7qg3QM\u0026q=85\u0026s=ab06b60ff809857744c52aab41791247","dark":"https://mintcdn.com/proceeds/SU359FAuaQ7qg3QM/logo/dark.png?fit=max\u0026auto=format\u0026n=SU359FAuaQ7qg3QM\u0026q=85\u0026s=b2359a16b90c8e991364cd82b88359f4"},"favicon":{"light":"https://mintcdn.com/proceeds/SU359FAuaQ7qg3QM/favicon-light.png?fit=max\u0026auto=format\u0026n=SU359FAuaQ7qg3QM\u0026q=85\u0026s=2281e5e5eb5a36fe0e52146c1fabaae1","dark":"https://mintcdn.com/proceeds/SU359FAuaQ7qg3QM/favicon-dark.png?fit=max\u0026auto=format\u0026n=SU359FAuaQ7qg3QM\u0026q=85\u0026s=a24e909ae87d0ae7211efc33b92e3164"},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"mailto:company@myproceeds.xyz","label":"Contact us"},{"href":"https://myproceeds.xyz/login","label":"Create account"}],"primary":{"type":"button","label":"Sign in","href":"https://myproceeds.xyz/login"}},"footer":{"socials":{"x":"https://x.com/apipaywall"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"proceeds","hasAudioNarration":false,"actualSubdomain":"proceeds","customDomains":["docs.myproceeds.xyz"],"gitSource":{"type":"github","owner":"myproceeds","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea4f70511dd8ff90ed202d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":17},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"CLI","count":6},{"language":"default","tag":"Manage","count":6},{"language":"default","tag":"Paywalls","count":5},{"language":"default","tag":"Services","count":5},{"language":"default","tag":"Agent Wallets","count":4},{"language":"default","tag":"Data","count":2},{"language":"default","tag":"Identity","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"guides/custom-headers-and-params","slug":"/guides/custom-headers-and-params","pageMetadata":{"title":"Custom headers and query parameters","description":"Forward extra request data to the upstream on a per-paywall basis.","href":"/guides/custom-headers-and-params"},"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: \"Forward extra request data to the upstream on a per-paywall basis.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Custom headers and query parameters live on the paywall, not the service. Use them when one specific endpoint needs additional context that the rest of the service doesn’t.`}),`\n`,_jsx(Heading,{level:`2`,id:`custom-headers`,children:`Custom headers`}),`\n`,_jsxs(_components.p,{children:[`Add a header name and value on the paywall. Proceeds attaches the header to every proxied request before forwarding it to the upstream `,_jsx(_components.code,{children:`Target URL`}),`.`]}),`\n`,_jsx(_components.p,{children:`Common uses:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Pinning an upstream API version: `,_jsx(_components.code,{children:`Accept-Version: 2026-04-01`})]}),`\n`,_jsxs(_components.li,{children:[`Identifying the calling product to a multi-tenant upstream: `,_jsx(_components.code,{children:`X-Tenant: weather`})]}),`\n`,_jsx(_components.li,{children:`Triggering upstream feature flags`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(_components.p,{children:`Add a parameter name and value on the paywall. Proceeds appends the parameter to the upstream URL.`}),`\n`,_jsx(_components.p,{children:`Common uses:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Pinning a model name on an inference API: `,_jsx(_components.code,{children:`model=claude-opus-4-7`})]}),`\n`,_jsxs(_components.li,{children:[`Forcing a specific data source: `,_jsx(_components.code,{children:`source=premium`})]}),`\n`,_jsxs(_components.li,{children:[`Locking a region: `,_jsx(_components.code,{children:`region=us-east-1`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`layering`,children:`Layering`}),`\n`,_jsxs(_components.p,{children:[`Headers and params `,_jsx(_components.strong,{children:`stack`}),` on top of upstream auth and the client’s own request:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Proceeds attaches upstream auth (configured at the service level).`}),`\n`,_jsx(_components.li,{children:`Proceeds attaches paywall custom headers and query parameters.`}),`\n`,_jsx(_components.li,{children:`The client’s request body and additional query parameters pass through unchanged.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If the same header name appears on both the paywall and the client request, the client value wins for non-auth headers. Auth headers configured via `,_jsx(_components.a,{href:`/guides/forward-upstream-auth`,children:`Forward upstream auth`}),` always win — they can’t be overridden by the client.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Use custom headers to pin sensitive defaults that you don’t want clients to override, like an API version or a tenant ID.`})})]})}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":"Custom headers and query parameters","description":"Forward extra request data to the upstream on a per-paywall basis.","href":"/guides/custom-headers-and-params"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Custom headers","slug":"custom-headers","depth":2,"children":[]},{"title":"Query parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Layering","slug":"layering","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"proceeds","siteName":"Proceeds","title":"Custom headers and query parameters - Proceeds","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-02T03:36:45.899Z","originalFileLocation":"guides/custom-headers-and-params.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=\"dark\"}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=\"Forward extra request data to the upstream on a per-paywall basis.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Proceeds\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_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/proceeds/zh-EAC2cRuPwGISG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Custom headers and query parameters - Proceeds\">\u003cmeta data-mint-head property=\"og:description\" content=\"Forward extra request data to the upstream on a per-paywall basis.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Proceeds\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.myproceeds.xyz/guides/custom-headers-and-params\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://proceeds.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Custom+headers+and+query+parameters\u0026amp;description=Forward+extra+request+data+to+the+upstream+on+a+per-paywall+basis.\u0026amp;theme=3b932dcfd6203c1e156d0750\u0026amp;signature=fd960297b66b56c2f9bb6d0ecbe090fea2413f547b497aee8f5ef8e94801310b\">\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=\"Custom headers and query parameters - Proceeds\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Forward extra request data to the upstream on a per-paywall basis.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://proceeds.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Custom+headers+and+query+parameters\u0026amp;description=Forward+extra+request+data+to+the+upstream+on+a+per-paywall+basis.\u0026amp;theme=3b932dcfd6203c1e156d0750\u0026amp;signature=fd960297b66b56c2f9bb6d0ecbe090fea2413f547b497aee8f5ef8e94801310b\">\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/proceeds/zh-EAC2cRuPwGISG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Proceeds\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.myproceeds.xyz/guides/custom-headers-and-params\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/custom-headers-and-params.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.myproceeds.xyz/#organization\",\"name\":\"Proceeds\",\"url\":\"https://docs.myproceeds.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/proceeds/SU359FAuaQ7qg3QM/logo/light.png?fit=max\u0026auto=format\u0026n=SU359FAuaQ7qg3QM\u0026q=85\u0026s=ab06b60ff809857744c52aab41791247\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.myproceeds.xyz#website\",\"name\":\"Proceeds\",\"url\":\"https://docs.myproceeds.xyz\",\"publisher\":{\"@id\":\"https://docs.myproceeds.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params#webpage\",\"url\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params\",\"name\":\"Custom headers and query parameters\",\"description\":\"Forward extra request data to the upstream on a per-paywall basis.\",\"dateModified\":\"2026-05-02T03:36:45.899Z\",\"isPartOf\":{\"@id\":\"https://docs.myproceeds.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.myproceeds.xyz/guides/accept-payments-from-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Custom headers and query parameters\",\"item\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params#article\",\"headline\":\"Custom headers and query parameters\",\"name\":\"Custom headers and query parameters\",\"description\":\"Forward extra request data to the upstream on a per-paywall basis.\",\"url\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params\",\"mainEntityOfPage\":{\"@id\":\"https://docs.myproceeds.xyz/guides/custom-headers-and-params#webpage\"},\"dateModified\":\"2026-05-02T03:36:45.899Z\",\"publisher\":{\"@id\":\"https://docs.myproceeds.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.myproceeds.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Proceeds\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Proceeds\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/custom-headers-and-params.md","siteName":"Proceeds","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"What is Proceeds?","sidebarTitle":"Overview","href":"/index"},{"title":"Create a service","href":"/quickstart/create-a-service"},{"title":"Add a paywall","href":"/quickstart/add-a-paywall"},{"title":"Monitor payments","href":"/quickstart/monitor-payments"},{"title":"Test paywalls","href":"/quickstart/test-paywalls"},{"title":"Set up an agent wallet","href":"/quickstart/set-up-an-agent-wallet"},{"title":"Make your first payment","href":"/quickstart/make-your-first-payment"}]},{"group":"Guides","pages":[{"title":"Sell to agents","sidebarTitle":"Sell to agents","href":"/guides/accept-payments-from-agents"},{"title":"Accept cards and Link (Stripe)","sidebarTitle":"Accept cards and Link","href":"/guides/accept-cards-and-link"},{"title":"Help agents call your API","sidebarTitle":"Agent guidance","href":"/guides/api-discovery"},{"title":"Configure pricing","href":"/guides/configure-pricing"},{"title":"Forward upstream auth","description":"Keep upstream API credentials inside Proceeds so clients never see them.","href":"/guides/forward-upstream-auth"},{"title":"Custom headers and query parameters","href":"/guides/custom-headers-and-params"},{"title":"Restrict HTTP methods","description":"Limit a paywall to specific HTTP methods so you only charge for the calls you intend to.","href":"/guides/restrict-http-methods"},{"title":"Settle to a wallet or bank","href":"/guides/settle-to-wallet-or-bank"},{"title":"Custom domains","href":"/guides/custom-domains"},{"title":"Supported blockchains","href":"/guides/supported-blockchains"},{"title":"Production checklist","href":"/guides/production-checklist"},{"title":"Troubleshooting","href":"/guides/troubleshooting"},{"title":"Concepts","href":"/concepts"},{"title":"How it works","href":"/how-it-works"}]},{"group":"Manage","pages":[{"title":"Paywalls","href":"/dashboard/paywalls"},{"title":"Transactions","href":"/dashboard/transactions"},{"title":"Events","href":"/dashboard/events"},{"title":"Wallet","sidebarTitle":"Wallet","href":"/dashboard/wallet"},{"title":"API Keys","href":"/dashboard/api-keys"},{"title":"Webhooks","href":"/dashboard/webhooks"}]},{"group":"API Reference","pages":[{"title":"REST API","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors \u0026 rate limits","href":"/api-reference/errors-and-rate-limits"},{"group":"System","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/health","href":"/api-reference/system/health-check"}]},{"group":"Services","pages":[{"title":"List services","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/services","href":"/api-reference/services/list-services"},{"title":"Create a service","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/services","href":"/api-reference/services/create-a-service"},{"title":"Get a service","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/services/{id}","href":"/api-reference/services/get-a-service"},{"title":"Delete a service","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/services/{id}","href":"/api-reference/services/delete-a-service"},{"title":"Update a service","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/services/{id}","href":"/api-reference/services/update-a-service"}]},{"group":"Paywalls","pages":[{"title":"List paywalls","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/paywalls","href":"/api-reference/paywalls/list-paywalls"},{"title":"Create a paywall","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/paywalls","href":"/api-reference/paywalls/create-a-paywall"},{"title":"Get a paywall","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/paywalls/{id}","href":"/api-reference/paywalls/get-a-paywall"},{"title":"Delete a paywall","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/paywalls/{id}","href":"/api-reference/paywalls/delete-a-paywall"},{"title":"Update a paywall","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/paywalls/{id}","href":"/api-reference/paywalls/update-a-paywall"}]},{"group":"Identity","pages":[{"title":"Validate the API key and return its tenant + scopes","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/me","href":"/api-reference/identity/validate-the-api-key-and-return-its-tenant-+-scopes"}]},{"group":"Data","pages":[{"title":"List the tenant's payment transactions","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/transactions","href":"/api-reference/data/list-the-tenants-payment-transactions"},{"title":"List the tenant's events","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/events","href":"/api-reference/data/list-the-tenants-events"}]}]},{"group":"CLI","pages":[{"title":"Proceeds CLI","sidebarTitle":"Introduction","href":"/cli/overview"},{"title":"Install the Proceeds CLI","sidebarTitle":"Install","href":"/cli/install"},{"title":"CLI authentication","sidebarTitle":"Authentication","href":"/cli/authentication"},{"title":"Services","sidebarTitle":"Services","href":"/cli/services"},{"title":"Paywalls","sidebarTitle":"Paywalls","href":"/cli/paywalls"},{"title":"Transactions and events","sidebarTitle":"Transactions","href":"/cli/transactions"}]},{"group":"Agent Wallets","pages":[{"title":"Pay with an agent","sidebarTitle":"Overview","href":"/agents/overview"},{"title":"AgentCash","href":"/agents/agentcash"},{"title":"Circle Agent Stack","href":"/agents/circle-agent-stack"},{"title":"Tempo Wallet","href":"/agents/tempo-wallet"}]}]},"basePath":"","title":"Custom headers and query parameters - Proceeds","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}