Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing.
Requires an API key with the metrics:ingest scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Optimaze","colors":{"primary":"#cbb000","light":"#fee855","dark":"#fbe86d"},"logo":{"light":"https://mintcdn.com/optimaze/RYRrg4xuV5ZodKp6/logo/OPTIMAZE_SECONDARY_LOGO_CLEAR_SPACE_GUIDE.png?fit=max\u0026auto=format\u0026n=RYRrg4xuV5ZodKp6\u0026q=85\u0026s=94c394f7ebaf5e7bb07b179c3ce5627d","dark":"https://mintcdn.com/optimaze/RYRrg4xuV5ZodKp6/logo/OPTIMAZE_SECONDARY_LOGO_WHITE_01.png?fit=max\u0026auto=format\u0026n=RYRrg4xuV5ZodKp6\u0026q=85\u0026s=8343bfad44394f9780deeff54abf20c3"},"favicon":{"light":"https://mintcdn.com/optimaze/H22rTqPFmthmkajv/logo/favicon-light.png?fit=max\u0026auto=format\u0026n=H22rTqPFmthmkajv\u0026q=85\u0026s=ca472a25cb740998f83243d1712d71fb","dark":"https://mintcdn.com/optimaze/H22rTqPFmthmkajv/logo/favicon-dark.png?fit=max\u0026auto=format\u0026n=H22rTqPFmthmkajv\u0026q=85\u0026s=52b6de4ffdd6137f7cc2cf4ad5f92c6c"},"api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"]}},"navbar":{"links":[{"icon":"message","href":"mailto:support@optimazehq.com","label":"Support"},{"icon":"blog","href":"https://optimazehq.com/resources/blog","label":"Blog"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/optimazehq"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"optimaze","hasAudioNarration":false,"actualSubdomain":"optimaze","customDomains":["docs.optimazehq.com"],"gitSource":{"type":"github","owner":"optimazeai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adea50f757645e9e4c95a59","collectionId":"aa2818c1-baf2-4e82-ac44-b9a2a544bb65","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adea50f757645e9e4c95a59"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adea50f757645e9e4c95a59","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Guides","count":27},{"language":"default","tag":"Connect data","count":8},{"language":"default","tag":"Explore","count":4},{"language":"default","tag":"Admin and security","count":4},{"language":"default","tag":"Model your spend","count":3},{"language":"default","tag":"Plan and measure","count":3},{"language":"default","tag":"API reference","count":2},{"language":"default","tag":"Reference","count":2},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"About the API","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--optimaze-yellow:#cbb000;--optimaze-yellow-light:#fee855;--optimaze-yellow-dark:#fbe86d}#page-title,h1{color:var(--optimaze-yellow)}.dark #page-title,.dark h1{color:var(--optimaze-yellow-dark)}#header .eyebrow{color:#18181b!important}.dark #header .eyebrow{color:#fafafa!important}"}],"page":{"pagePath":"api-reference/business-metrics/ingest-business-metric-datapoints","slug":"/api-reference/business-metrics/ingest-business-metric-datapoints","pageMetadata":{"title":"Ingest business metric datapoints","description":"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing.\n\nRequires an API key with the **metrics:ingest** scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/metrics/ingest","href":"/api-reference/business-metrics/ingest-business-metric-datapoints","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requires an API key with the \", _jsx(_components.strong, {\n children: \"metrics:ingest\"\n }), \" scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.\"]\n })]\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":"Ingest business metric datapoints","description":"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing.\n\nRequires an API key with the **metrics:ingest** scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/metrics/ingest","href":"/api-reference/business-metrics/ingest-business-metric-datapoints","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ingestBusinessMetricDatapoints","summary":"Ingest business metric datapoints","description":"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing.\n\nRequires an API key with the **metrics:ingest** scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.","tags":["Business metrics"],"requestBody":"9e885425-d33d-4580-a75d-a4b82150d35a","responses":{"202":"f788a682-b99c-450b-aabb-91e99e1c5db5","400":"d487473d-48d9-4845-ad05-a6c7c9bb3860","401":"b4fbf8be-f23c-4d9b-8eec-aecb7a45fa76","403":"6753feeb-466e-4282-a783-ada189d10a1f"},"security":["a0d0d320-a60c-45dc-8317-6e1d710a2118"],"method":"post","type":"path","servers":["39b0218d-ea88-45f0-ad6e-723b84a6bf6c"],"path":"/v1/metrics/ingest","baseUrlOptions":["https://api.optimazehq.com"],"title":"Ingest business metric datapoints","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["metric_id","data"],"properties":{"metric_id":{"type":"string","description":"Customer metric ID defined in the Optimaze dashboard.","isRequired":true,"uniqueKey":"metric_id","typeLabel":"string"},"data":{"type":"array","minItems":1,"items":{"type":"object","required":["event_time","value"],"properties":{"event_time":{"type":"string","format":"date-time","description":"RFC3339 timestamp when the observation occurred.","isRequired":true,"uniqueKey":"data.items.[INDEX].event_time","typeLabel":"string\u003cdate-time>"},"value":{"type":"number","description":"Numeric metric value.","isRequired":true,"uniqueKey":"data.items.[INDEX].value","typeLabel":"number"},"tags":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"data.items.[INDEX].tags.additionalProperties","typeLabel":"string"},"description":"Optional key-value dimensions (for example region or product line).","uniqueKey":"data.items.[INDEX].tags","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"source":{"type":"string","description":"Originating system identifier. Defaults to ingest-api when omitted.","uniqueKey":"source","typeLabel":"string"},"sample_rate":{"type":"number","minimum":0,"maximum":1,"description":"Sampling rate between 0 and 1. Defaults to 1.0.","uniqueKey":"sample_rate","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"examples":{"singleDatapoint":{"title":"singleDatapoint","value":{"metric_id":"123456789","source":"finance-warehouse","sample_rate":1,"data":[{"event_time":"2026-01-31T23:59:59Z","value":48250,"tags":{"currency":"AUD","plan":"enterprise"}}]}},"batchDatapoints":{"title":"batchDatapoints","value":{"metric_id":"123456789","source":"billing-system","data":[{"event_time":"2026-01-15T10:30:00Z","value":125000.5,"tags":{"region":"ap-southeast-2","plan":"enterprise"}},{"event_time":"2026-01-15T11:30:00Z","value":126100.25,"tags":{"region":"ap-southeast-2","plan":"enterprise"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f788a682-b99c-450b-aabb-91e99e1c5db5":{"description":"Datapoints accepted and queued for processing","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d487473d-48d9-4845-ad05-a6c7c9bb3860":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b4fbf8be-f23c-4d9b-8eec-aecb7a45fa76":{"description":"Missing or invalid API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6753feeb-466e-4282-a783-ada189d10a1f":{"description":"API key lacks metrics:ingest scope or organisation mismatch","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"a0d0d320-a60c-45dc-8317-6e1d710a2118":{"optimazeApiKey":{"type":"apiKey","in":"header","name":"optimaze-api-key","description":"Raw Optimaze API key (format omz_...). Created in the dashboard with the required scopes.","scopes":[],"schemeName":"optimazeApiKey"},"optimazeOrgId":{"type":"apiKey","in":"header","name":"optimaze-org-id","description":"Optimaze organisation ID for the integration.","scopes":[],"schemeName":"optimazeOrgId"}}},"servers":{"39b0218d-ea88-45f0-ad6e-723b84a6bf6c":{"url":"https://api.optimazehq.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"optimaze-api-key","description":"Raw Optimaze API key (format omz_...). Created in the dashboard with the required scopes.","scopes":[],"schemeName":"optimazeApiKey"},"schema":{"title":"optimaze-api-key","type":"string","description":"Raw Optimaze API key (format omz_...). Created in the dashboard with the required scopes.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"optimazeApiKey","name":"optimaze-api-key"},{"scheme":{"type":"apiKey","in":"header","name":"optimaze-org-id","description":"Optimaze organisation ID for the integration.","scopes":[],"schemeName":"optimazeOrgId"},"schema":{"title":"optimaze-org-id","type":"string","description":"Optimaze organisation ID for the integration.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"optimazeOrgId","name":"optimaze-org-id"}],"title":"optimazeApiKey \u0026 optimazeOrgId"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"optimaze","siteName":"Optimaze","title":"Ingest business metric datapoints - Optimaze","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T04:57:18.074Z","originalFileLocation":"api-reference/business-metrics/ingest-business-metric-datapoints.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=\"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing. Requires an API key with the metrics:ingest scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Optimaze\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_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/optimaze/S5s3oEEQX6nLha_t/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ingest business metric datapoints - Optimaze\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing. Requires an API key with the metrics:ingest scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Optimaze\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://optimaze.mintlify.app/_mintlify/api/og/v2?division=Business+metrics\u0026amp;title=Ingest+business+metric+datapoints\u0026amp;description=Submit+one+or+more+datapoints+for+a+customer-defined+business+metric.+Returns+202+when+the+payload+is+valid+and+queued+for+processing.%0A%0ARequires+an+API+key+with\u0026amp;theme=62f3b13d474ed9f06ac3e508\u0026amp;signature=f9a488a0ce5b706e40abdf6c8f4fb133872445496629979622c0e01f3763f5e4\">\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=\"Ingest business metric datapoints - Optimaze\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing. Requires an API key with the metrics:ingest scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://optimaze.mintlify.app/_mintlify/api/og/v2?division=Business+metrics\u0026amp;title=Ingest+business+metric+datapoints\u0026amp;description=Submit+one+or+more+datapoints+for+a+customer-defined+business+metric.+Returns+202+when+the+payload+is+valid+and+queued+for+processing.%0A%0ARequires+an+API+key+with\u0026amp;theme=62f3b13d474ed9f06ac3e508\u0026amp;signature=f9a488a0ce5b706e40abdf6c8f4fb133872445496629979622c0e01f3763f5e4\">\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/optimaze/S5s3oEEQX6nLha_t/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Optimaze\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#cbb000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/business-metrics/ingest-business-metric-datapoints.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.optimazehq.com/#organization\",\"name\":\"Optimaze\",\"url\":\"https://docs.optimazehq.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/optimaze/RYRrg4xuV5ZodKp6/logo/OPTIMAZE_SECONDARY_LOGO_CLEAR_SPACE_GUIDE.png?fit=max\u0026auto=format\u0026n=RYRrg4xuV5ZodKp6\u0026q=85\u0026s=94c394f7ebaf5e7bb07b179c3ce5627d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.optimazehq.com#website\",\"name\":\"Optimaze\",\"url\":\"https://docs.optimazehq.com\",\"publisher\":{\"@id\":\"https://docs.optimazehq.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints#webpage\",\"url\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints\",\"name\":\"Ingest business metric datapoints\",\"description\":\"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing. Requires an API key with the metrics:ingest scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.\",\"dateModified\":\"2026-10-14T04:57:18.074Z\",\"isPartOf\":{\"@id\":\"https://docs.optimazehq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Optimaze\",\"item\":\"https://docs.optimazehq.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ingest business metric datapoints\",\"item\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints#apireference\",\"headline\":\"Ingest business metric datapoints\",\"name\":\"Ingest business metric datapoints\",\"description\":\"Submit one or more datapoints for a customer-defined business metric. Returns 202 when the payload is valid and queued for processing. Requires an API key with the metrics:ingest scope. Create metric definitions in the Optimaze dashboard before calling this endpoint. See Authentication in the API tab for key setup.\",\"url\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints\",\"mainEntityOfPage\":{\"@id\":\"https://docs.optimazehq.com/api-reference/business-metrics/ingest-business-metric-datapoints#webpage\"},\"dateModified\":\"2026-10-14T04:57:18.074Z\",\"publisher\":{\"@id\":\"https://docs.optimazehq.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.optimazehq.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Optimaze\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Optimaze","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"About the API","pages":[{"title":"Introduction","description":"Programmatic access to the Optimaze platform via API keys and scoped HTTP endpoints.","href":"/api-reference/introduction"}]},{"group":"API Reference","pages":[{"group":"Business metrics","pages":[{"title":"Ingest business metric datapoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/metrics/ingest","href":"/api-reference/business-metrics/ingest-business-metric-datapoints"}]}]}]}]},"title":"Ingest business metric datapoints - Optimaze","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}