{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bitwage Partner API","colors":{"primary":"#0066FF","light":"#3388FF","dark":"#0044CC"},"logo":{"light":"https://mintcdn.com/bitwageinc/j-qOCmozQFjAAhMm/images/bitwage-logo.svg?fit=max\u0026auto=format\u0026n=j-qOCmozQFjAAhMm\u0026q=85\u0026s=408561ad2fb2f08282b21a52b1a44ee8","dark":"https://mintcdn.com/bitwageinc/j-qOCmozQFjAAhMm/images/bitwage-logo-dark.svg?fit=max\u0026auto=format\u0026n=j-qOCmozQFjAAhMm\u0026q=85\u0026s=e3535b7dc77ee95fee8263a7858d8e15"},"favicon":"https://mintcdn.com/bitwageinc/O-dDoRMLusYoPDD1/images/favicon.png?fit=max\u0026auto=format\u0026n=O-dDoRMLusYoPDD1\u0026q=85\u0026s=50c6c7914c4d6c0664ba49e79c3c1dac","navbar":{"links":[{"href":"mailto:developers@bitwage.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.bitwage.com"}},"footer":{"socials":{"x":"https://x.com/Bitwage","linkedin":"https://www.linkedin.com/company/bitwage","github":"https://github.com/nicobitwage"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://app.bitwage.com"},{"anchor":"Website","icon":"globe","href":"https://www.bitwage.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bitwageinc","hasAudioNarration":false,"actualSubdomain":"bitwageinc","customDomains":["developer.bitwage.com"],"gitSource":{"type":"github","owner":"inwage","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a303238e431c313e5614969","collectionId":"d75ef07d-1456-449c-9400-eccc5bcc3b8f","schemaVersion":"v3"},"entitlements":{},"buildId":"6a303238e431c313e5614969:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":53},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Companies","count":7},{"language":"default","tag":"User Distributions","count":6},{"language":"default","tag":"Company Payroll","count":5},{"language":"default","tag":"Company Recipients","count":5},{"language":"default","tag":"User Payers","count":5},{"language":"default","tag":"Concepts","count":4},{"language":"default","tag":"Company Workers","count":4},{"language":"default","tag":"Users","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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/company-payroll/create-payroll","slug":"/api-reference/company-payroll/create-payroll","pageMetadata":{"title":"Create payroll","description":"Create a payroll to pay company workers. When using API key\nauthentication, an `Idempotency-Key` header is required.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/payroll/create","href":"/api-reference/company-payroll/create-payroll","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 code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a payroll to pay company workers. When using API key\\nauthentication, an \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" header is required.\"]\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 payroll","description":"Create a payroll to pay company workers. When using API key\nauthentication, an `Idempotency-Key` header is required.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/payroll/create","href":"/api-reference/company-payroll/create-payroll","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createPayroll","tags":["Company Payroll"],"summary":"Create payroll","description":"Create a payroll to pay company workers. When using API key\nauthentication, an `Idempotency-Key` header is required.\n","parameters":["66ce5cd1-6ffb-44e1-8225-0f2938e23075"],"requestBody":"1f924815-a59c-4e99-8075-a5ff71bd892a","responses":{"200":"3f91b5ff-52e4-489b-9bd9-ae23d25c2767"},"method":"post","type":"path","servers":["c4fadea6-c6fc-4cd7-9af2-f0a24c7851eb","b5be24fa-7039-4be1-98af-473320f4f9db"],"security":["409e9c47-4575-4830-92ef-6bf1cb53bb5a","bbb25f4a-2f71-400b-8c54-ca12d8b4a8ee"],"path":"/api/company/payroll/create","baseUrlOptions":["https://api.sandbox.bitwage.com","https://api2.bitwage.com"],"title":"Create payroll","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"66ce5cd1-6ffb-44e1-8225-0f2938e23075":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"Unique key for idempotent requests. Recommended for all write operations.","uniqueKey":"","typeLabel":"string"},"description":"Unique key for idempotent requests. Recommended for all write operations."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["company_id","to_pay"],"properties":{"company_id":{"type":"string","isRequired":true,"uniqueKey":"company_id","typeLabel":"string"},"to_pay":{"type":"array","minItems":1,"items":{"type":"object","required":["amount_fiat"],"properties":{"amount_fiat":{"type":"number","format":"double","description":"Payment amount in fiat currency.","isRequired":true,"uniqueKey":"to_pay.items.[INDEX].amount_fiat","typeLabel":"number\u003cdouble>"},"user_id":{"type":"string","description":"Recipient user ID. One of `user_id` or `company_id` is required.","uniqueKey":"to_pay.items.[INDEX].user_id","typeLabel":"string"},"company_id":{"type":"string","description":"Recipient company ID. One of `user_id` or `company_id` is required.","uniqueKey":"to_pay.items.[INDEX].company_id","typeLabel":"string"},"country":{"type":"string","uniqueKey":"to_pay.items.[INDEX].country","typeLabel":"string"},"is_premium":{"type":"boolean","default":false,"uniqueKey":"to_pay.items.[INDEX].is_premium","typeLabel":"boolean"},"invoice_id":{"type":"string","uniqueKey":"to_pay.items.[INDEX].invoice_id","typeLabel":"string"},"description":{"type":"string","uniqueKey":"to_pay.items.[INDEX].description","typeLabel":"string"},"category":{"type":"string","uniqueKey":"to_pay.items.[INDEX].category","typeLabel":"string"},"external_payment_id":{"type":"string","uniqueKey":"to_pay.items.[INDEX].external_payment_id","typeLabel":"string"}},"uniqueKey":"to_pay.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"to_pay","typeLabel":"object[]"},"funding_method":{"type":"string","description":"Funding method override. Uses company default if not provided.","uniqueKey":"funding_method","typeLabel":"string"},"funding_currency":{"type":"string","description":"Funding currency for crypto payments.","uniqueKey":"funding_currency","typeLabel":"string"},"currency":{"type":"string","description":"Payroll denomination currency.","uniqueKey":"currency","typeLabel":"string"},"external_id":{"type":"string","description":"Your external reference ID for this payroll.","uniqueKey":"external_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"company_id":"\u003cstring>","to_pay":[{"amount_fiat":123,"user_id":"\u003cstring>","company_id":"\u003cstring>","country":"\u003cstring>","is_premium":false,"invoice_id":"\u003cstring>","description":"\u003cstring>","category":"\u003cstring>","external_payment_id":"\u003cstring>"}],"funding_method":"\u003cstring>","funding_currency":"\u003cstring>","currency":"\u003cstring>","external_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3f91b5ff-52e4-489b-9bd9-ae23d25c2767":{"description":"Payroll created.","content":{"application/json":{"schema":{"type":"object","properties":{"payroll_id":{"type":"string","uniqueKey":"payroll_id","typeLabel":"string"},"fees":{"type":"number","format":"double","uniqueKey":"fees","typeLabel":"number\u003cdouble>"},"volume_input_in_input_currency":{"type":"number","format":"double","uniqueKey":"volume_input_in_input_currency","typeLabel":"number\u003cdouble>"},"total_input_in_input_currency":{"type":"number","format":"double","uniqueKey":"total_input_in_input_currency","typeLabel":"number\u003cdouble>"},"quote":{"type":"object","properties":{"quote_id":{"type":"string","uniqueKey":"quote.quote_id","typeLabel":"string"},"valid_from":{"type":"string","format":"date-time","uniqueKey":"quote.valid_from","typeLabel":"string\u003cdate-time>"},"valid_to":{"type":"string","format":"date-time","uniqueKey":"quote.valid_to","typeLabel":"string\u003cdate-time>"},"rate":{"type":"number","format":"double","uniqueKey":"quote.rate","typeLabel":"number\u003cdouble>"},"funding_currency":{"type":"string","uniqueKey":"quote.funding_currency","typeLabel":"string"},"funding_amount":{"type":"number","format":"double","uniqueKey":"quote.funding_amount","typeLabel":"number\u003cdouble>"},"funding_details":{"type":"object","properties":{"address":{"type":"string","description":"Crypto address for funding.","uniqueKey":"quote.funding_details.address","typeLabel":"string"},"network":{"type":"string","description":"Blockchain network.","uniqueKey":"quote.funding_details.network","typeLabel":"string"}},"uniqueKey":"quote.funding_details","typeLabel":"object"}},"uniqueKey":"quote","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"payroll_id":"\u003cstring>","fees":123,"volume_input_in_input_currency":123,"total_input_in_input_currency":123,"quote":{"quote_id":"\u003cstring>","valid_from":"2023-11-07T05:31:56Z","valid_to":"2023-11-07T05:31:56Z","rate":123,"funding_currency":"\u003cstring>","funding_amount":123,"funding_details":{"address":"\u003cstring>","network":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"409e9c47-4575-4830-92ef-6bf1cb53bb5a":{"api_key":{"type":"http","scheme":"basic","description":"API key authentication. Include your access token as:\n`Authorization: Basic \u003cACCESS_TOKEN>`\n","scopes":[]}},"bbb25f4a-2f71-400b-8c54-ca12d8b4a8ee":{"oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.bitwage.com/authorize","tokenUrl":"https://api2.bitwage.com/oauth2/token","scopes":{"c_company_detail":"Company Detail","c_company_worker_list":"Company Worker List","c_company_worker_invitations_list":"Company Worker Invitation List","c_company_workers_invite":"Company Workers Invite","c_company_workers_pay":"Company Workers Pay","u_user_create":"User Create","u_user_update":"User Update","u_user_update_doc":"User Update Document","u_user_payer_create":"User Payer Create","u_user_payer_update":"User Payer Update","u_user_invoice_create":"User Invoice Create","u_user_invoice_delete":"User Invoice Delete","u_user_detail":"User Detail","u_user_document_list":"User Document List","u_user_payer_detail":"User Payer Detail","u_user_payer_list":"User Payer List","u_user_bank_details":"User Bank Details","u_user_invoice_detail":"User Invoice Detail","u_user_invoice_list":"User Invoice List","u_user_distribution_detail":"User Distribution Detail","u_user_distribution_list":"User Distribution List","u_user_distribution_create":"User Distribution Create","u_user_distribution_update":"User Distribution Update","u_user_kyc_initiate":"User Initiate KYC"}}},"scopes":[]}}},"servers":{"c4fadea6-c6fc-4cd7-9af2-f0a24c7851eb":{"url":"https://api.sandbox.bitwage.com","description":"Sandbox"},"b5be24fa-7039-4be1-98af-473320f4f9db":{"url":"https://api2.bitwage.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"API key authentication. Include your access token as:\n`Authorization: Basic \u003cACCESS_TOKEN>`\n","scopes":[]},"schema":{"title":"Basic Auth","type":"object","description":"API key authentication. Include your access token as:\n`Authorization: Basic \u003cACCESS_TOKEN>`\n","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":"api_key","name":"Authorization"}],"title":"api_key"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.bitwage.com/authorize","tokenUrl":"https://api2.bitwage.com/oauth2/token","scopes":{"c_company_detail":"Company Detail","c_company_worker_list":"Company Worker List","c_company_worker_invitations_list":"Company Worker Invitation List","c_company_workers_invite":"Company Workers Invite","c_company_workers_pay":"Company Workers Pay","u_user_create":"User Create","u_user_update":"User Update","u_user_update_doc":"User Update Document","u_user_payer_create":"User Payer Create","u_user_payer_update":"User Payer Update","u_user_invoice_create":"User Invoice Create","u_user_invoice_delete":"User Invoice Delete","u_user_detail":"User Detail","u_user_document_list":"User Document List","u_user_payer_detail":"User Payer Detail","u_user_payer_list":"User Payer List","u_user_bank_details":"User Bank Details","u_user_invoice_detail":"User Invoice Detail","u_user_invoice_list":"User Invoice List","u_user_distribution_detail":"User Distribution Detail","u_user_distribution_list":"User Distribution List","u_user_distribution_create":"User Distribution Create","u_user_distribution_update":"User Distribution Update","u_user_kyc_initiate":"User Initiate KYC"}}},"scopes":[]},"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"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"bitwageinc","siteName":"Bitwage Partner API","title":"Create payroll - Bitwage Partner API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-26T19:27:50.299Z","originalFileLocation":"api-reference/company-payroll/create-payroll.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 payroll to pay company workers. When using API key authentication, an Idempotency-Key header is required.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bitwage Partner API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_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/bitwageinc/AzN5_NKA8rFppSaK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create payroll - Bitwage Partner API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a payroll to pay company workers. When using API key authentication, an Idempotency-Key header is required.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bitwage Partner API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bitwageinc.mintlify.app/_mintlify/api/og/v2?division=Company+Payroll\u0026amp;title=Create+payroll\u0026amp;description=Create+a+payroll+to+pay+company+workers.+When+using+API+key%0Aauthentication%2C+an+%60Idempotency-Key%60+header+is+required.%0A\u0026amp;theme=300de9e74e4337cf6b4553ec\u0026amp;signature=e6812940ad9ee8f3bffae48653073f94d029fa9fae9978d9a25eecae637f20f7\">\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 payroll - Bitwage Partner API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a payroll to pay company workers. When using API key authentication, an Idempotency-Key header is required.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bitwageinc.mintlify.app/_mintlify/api/og/v2?division=Company+Payroll\u0026amp;title=Create+payroll\u0026amp;description=Create+a+payroll+to+pay+company+workers.+When+using+API+key%0Aauthentication%2C+an+%60Idempotency-Key%60+header+is+required.%0A\u0026amp;theme=300de9e74e4337cf6b4553ec\u0026amp;signature=e6812940ad9ee8f3bffae48653073f94d029fa9fae9978d9a25eecae637f20f7\">\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/bitwageinc/AzN5_NKA8rFppSaK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bitwage Partner API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/company-payroll/create-payroll.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.bitwage.com/#organization\",\"name\":\"Bitwage Partner API\",\"url\":\"https://developer.bitwage.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bitwageinc/j-qOCmozQFjAAhMm/images/bitwage-logo.svg?fit=max\u0026auto=format\u0026n=j-qOCmozQFjAAhMm\u0026q=85\u0026s=408561ad2fb2f08282b21a52b1a44ee8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.bitwage.com#website\",\"name\":\"Bitwage Partner API\",\"url\":\"https://developer.bitwage.com\",\"publisher\":{\"@id\":\"https://developer.bitwage.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll#webpage\",\"url\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll\",\"name\":\"Create payroll\",\"description\":\"Create a payroll to pay company workers. When using API key authentication, an Idempotency-Key header is required.\",\"dateModified\":\"2026-05-26T19:27:50.299Z\",\"isPartOf\":{\"@id\":\"https://developer.bitwage.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bitwage Partner API\",\"item\":\"https://developer.bitwage.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create payroll\",\"item\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll#apireference\",\"headline\":\"Create payroll\",\"name\":\"Create payroll\",\"description\":\"Create a payroll to pay company workers. When using API key authentication, an Idempotency-Key header is required.\",\"url\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll\",\"mainEntityOfPage\":{\"@id\":\"https://developer.bitwage.com/api-reference/company-payroll/create-payroll#webpage\"},\"dateModified\":\"2026-05-26T19:27:50.299Z\",\"publisher\":{\"@id\":\"https://developer.bitwage.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.bitwage.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bitwage Partner API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bitwage Partner API","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://app.bitwage.com"},{"anchor":"Website","icon":"globe","href":"https://www.bitwage.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Authorization","pages":[{"title":"Request authorization code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /authorize","href":"/api-reference/authorization/request-authorization-code"},{"title":"Exchange authorization code for access token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /oauth2/token","href":"/api-reference/authorization/exchange-authorization-code-for-access-token"}]},{"group":"Users","pages":[{"title":"Create user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/create","href":"/api-reference/users/create-user"},{"title":"Update user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/update","href":"/api-reference/users/update-user"},{"title":"Get user details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/detail","href":"/api-reference/users/get-user-details"},{"title":"Initiate user KYC","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/kyc-initiate","href":"/api-reference/users/initiate-user-kyc"}]},{"group":"User Documents","pages":[{"title":"Upload user document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/document/upload","href":"/api-reference/user-documents/upload-user-document"},{"title":"List user documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/document/list","href":"/api-reference/user-documents/list-user-documents"},{"title":"Get required document types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/document/types","href":"/api-reference/user-documents/get-required-document-types"}]},{"group":"User Payers","pages":[{"title":"Create payer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/payer/create","href":"/api-reference/user-payers/create-payer"},{"title":"Update payer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/payer/update","href":"/api-reference/user-payers/update-payer"},{"title":"Delete payer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/payer/delete","href":"/api-reference/user-payers/delete-payer"},{"title":"Get payer details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/payer/detail","href":"/api-reference/user-payers/get-payer-details"},{"title":"List payers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/payer/list","href":"/api-reference/user-payers/list-payers"}]},{"group":"User Distributions","pages":[{"title":"Get distribution fields","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/distribution/fields","href":"/api-reference/user-distributions/get-distribution-fields"},{"title":"Create distribution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/distribution","href":"/api-reference/user-distributions/create-distribution"},{"title":"Delete distribution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/user/distribution","href":"/api-reference/user-distributions/delete-distribution"},{"title":"Update distribution allocations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/user/distribution/allocations","href":"/api-reference/user-distributions/update-distribution-allocations"},{"title":"Get distribution details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/distribution/detail","href":"/api-reference/user-distributions/get-distribution-details"},{"title":"List distributions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/distribution/list","href":"/api-reference/user-distributions/list-distributions"}]},{"group":"User Funding","pages":[{"title":"Get funding account details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/user/funding/account","href":"/api-reference/user-funding/get-funding-account-details"},{"title":"Create funding account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/user/funding/account","href":"/api-reference/user-funding/create-funding-account"}]},{"group":"Companies","pages":[{"title":"Create company","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/companies","href":"/api-reference/companies/create-company"},{"title":"Get company details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/company","href":"/api-reference/companies/get-company-details"},{"title":"Create UBO admin","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/companies/{company_id}/ubo","href":"/api-reference/companies/create-ubo-admin"},{"title":"Submit UBO KYC","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/companies/{company_id}/ubo/kyc","href":"/api-reference/companies/submit-ubo-kyc"},{"title":"Upload company documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/companies/{company_id}/documents","href":"/api-reference/companies/upload-company-documents"},{"title":"Get KYB status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/companies/{company_id}/kyb","href":"/api-reference/companies/get-kyb-status"},{"title":"Submit company KYB","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/companies/{company_id}/kyb","href":"/api-reference/companies/submit-company-kyb"}]},{"group":"Company Workers","pages":[{"title":"List company workers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/company/workers","href":"/api-reference/company-workers/list-company-workers"},{"title":"Invite workers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/workers/invite","href":"/api-reference/company-workers/invite-workers"},{"title":"Resend worker invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/worker/invite/resend","href":"/api-reference/company-workers/resend-worker-invitation"},{"title":"List worker invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/company/worker/invitations","href":"/api-reference/company-workers/list-worker-invitations"}]},{"group":"Company Recipients","pages":[{"title":"List company recipients","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/company/recipients","href":"/api-reference/company-recipients/list-company-recipients"},{"title":"Create recipient","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/{company_id}/recipients/create","href":"/api-reference/company-recipients/create-recipient"},{"title":"Create recipient distribution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/{company_id}/recipients/{recipient_id}/distribution","href":"/api-reference/company-recipients/create-recipient-distribution"},{"title":"Delete recipient distribution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/company/{company_id}/recipients/{recipient_id}/distribution","href":"/api-reference/company-recipients/delete-recipient-distribution"},{"title":"Set recipient distribution allocations","description":"Set allocation percentages for a company recipient's distributions.\nTotal must equal 100. Maximum 3 distributions.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/company/{company_id}/recipients/{recipient_id}/distribution/allocations","href":"/api-reference/company-recipients/set-recipient-distribution-allocations"}]},{"group":"Company Payroll","pages":[{"title":"Create payroll","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/payroll/create","href":"/api-reference/company-payroll/create-payroll"},{"title":"Refresh payroll quotes","description":"Refresh expired crypto funding quotes for a payroll.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/company/payroll/quote/refresh","href":"/api-reference/company-payroll/refresh-payroll-quotes"},{"title":"Create vendor payroll quotes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/vendor/payroll/quotes","href":"/api-reference/company-payroll/create-vendor-payroll-quotes"},{"title":"Create vendor payroll document upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/vendor/payroll/documents","href":"/api-reference/company-payroll/create-vendor-payroll-document-upload"},{"title":"Create vendor payroll","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/vendor/payroll","href":"/api-reference/company-payroll/create-vendor-payroll"}]},{"group":"Merchant","pages":[{"title":"Create merchant claim","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/merchant/claim/create","href":"/api-reference/merchant/create-merchant-claim"},{"title":"Refresh merchant claim quote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/merchant/claim/quote/refresh","href":"/api-reference/merchant/refresh-merchant-claim-quote"},{"title":"Get merchant claim status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/merchant/claim/status","href":"/api-reference/merchant/get-merchant-claim-status"}]},{"group":"Wallets","pages":[{"title":"Request wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/wallets/request","href":"/api-reference/wallets/request-wallet"},{"title":"List wallets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/wallets","href":"/api-reference/wallets/list-wallets"},{"title":"List wallet transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/wallets/transactions","href":"/api-reference/wallets/list-wallet-transactions"}]},{"group":"Webhooks","pages":[{"title":"User kyc status update","version":null,"deprecated":null,"openapi":"/api-reference/openapi.yaml webhook userKYCStatusUpdate","href":"/api-reference/webhooks/user-kyc-status-update"},{"title":"User payment status update","version":null,"deprecated":null,"openapi":"/api-reference/openapi.yaml webhook userPaymentStatusUpdate","href":"/api-reference/webhooks/user-payment-status-update"},{"title":"Payroll created","version":null,"deprecated":null,"openapi":"/api-reference/openapi.yaml webhook payrollCreated","href":"/api-reference/webhooks/payroll-created"},{"title":"Funding account status update","version":null,"deprecated":null,"openapi":"/api-reference/openapi.yaml webhook userFundingAccountStatus","href":"/api-reference/webhooks/funding-account-status-update"}]}]}]},"title":"Create payroll - Bitwage Partner API","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"]}