Some applications may need customers to authorize other systems on their behalf. With the ‘totp’ endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Masivo","colors":{"primary":"#9333ea","light":"#c084fc","dark":"#9333ea"},"logo":{"light":"https://mintcdn.com/trd/7W_vRQTxJHIpxqe2/logo/light.svg?fit=max\u0026auto=format\u0026n=7W_vRQTxJHIpxqe2\u0026q=85\u0026s=d6c63ec91328f53e2881c4b8c6463002","dark":"https://mintcdn.com/trd/7W_vRQTxJHIpxqe2/logo/dark.svg?fit=max\u0026auto=format\u0026n=7W_vRQTxJHIpxqe2\u0026q=85\u0026s=4f3a37e246a4bdd211beae4f51571bea","href":"/"},"favicon":"https://mintcdn.com/trd/7W_vRQTxJHIpxqe2/favicon.svg?fit=max\u0026auto=format\u0026n=7W_vRQTxJHIpxqe2\u0026q=85\u0026s=d626565ed6bd780993b9f7d91f7ab1be","navbar":{"links":[{"href":"mailto:soporte@trade.ec?subject=Masivo Support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.masivo.ai"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://www.linkedin.com/company/mintsearch"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Roadmap","icon":"map","href":"https://docs.masivo.ai/roadmap"},{"anchor":"Changelog","icon":"rocket","href":"https://docs.masivo.ai/changelog"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/2DgqGUej"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trd","hasAudioNarration":false,"actualSubdomain":"trd","customDomains":["docs.masivo.ai"],"gitSource":{"type":"github","owner":"trade-ec","repo":"masivo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae342ccbefa89197b169622","collectionId":"f24d0b41-a58e-4ab3-99cd-6de00b6e057b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae342ccbefa89197b169622"},"entitlements":{},"buildId":"6ae342ccbefa89197b169622","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":93},{"language":"default","tag":"Documentation","count":88},{"language":"default","tag":"Endpoints","count":73},{"language":"default","tag":"Guides","count":72},{"language":"default","tag":"Get Started","count":23},{"language":"default","tag":"Concepts","count":20},{"language":"default","tag":"Marketing Automation","count":19},{"language":"default","tag":"Customers","count":17},{"language":"default","tag":"CDP","count":17},{"language":"default","tag":"Integrations","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/auth/totp/post","slug":"/api-reference/auth/totp/post","pageMetadata":{"title":"Request TOTP","openapi":"POST /auth/totp","description":"Some applications may need customers to authorize other systems on their behalf. With the 'totp' endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.","href":"/api-reference/auth/totp/post"},"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: \"Some applications may need customers to authorize other systems on their behalf. With the ‘totp’ endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.\"\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":"Request TOTP","openapi":"POST /auth/totp","description":"Some applications may need customers to authorize other systems on their behalf. With the 'totp' endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.","href":"/api-reference/auth/totp/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Some applications may need customers to authorize other systems on their behalf. With the 'totp' endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.","requestBody":"5f5005e6-bf80-4f83-bf7c-ea3f128cb10d","responses":{"201":"29919a58-6cd4-4419-b889-0bc8c194e19a","404":"8825881e-0ba1-4208-984e-b45e20aa7c89"},"method":"post","type":"path","servers":["bfa79d19-faf8-4b65-9f12-2bd5b6069d7f"],"security":["e5fbaeb9-73b3-4320-8dec-e2c171b31efa"],"path":"/auth/totp","baseUrlOptions":["https://app.masivo.ai/api/storefront/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["customer_id"],"properties":{"customer_id":{"type":"string","description":"The customer unique identifier","isRequired":true,"uniqueKey":"customer_id","typeLabel":"string"},"metadata":{"type":"object","description":"Optional field for additional information","uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"29919a58-6cd4-4419-b889-0bc8c194e19a":{"description":"TOTP token created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"code":{"type":"string","description":"Time base - One time password","example":"1234","uniqueKey":"data.code","typeLabel":"string"},"expired_at":{"type":"string","description":"The time when the token expires","format":"date-time","uniqueKey":"data.expired_at","typeLabel":"string\u003cdate-time>"},"seconds_left":{"type":"number","description":"The number of seconds left until the token expires","uniqueKey":"data.seconds_left","typeLabel":"number"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"code":"1234","expired_at":"2023-11-07T05:31:56Z","seconds_left":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"8825881e-0ba1-4208-984e-b45e20aa7c89":{"description":"Customer not found","content":{"application/json":{"schema":{"required":["error","details"],"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","isRequired":true,"uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidCoupon":{"title":"invalidCoupon","value":{"error":"Internal validation failed","details":"Invalid coupon"}},"ecommerceScopeMismatch":{"title":"ecommerceScopeMismatch","value":{"error":"Internal validation failed","details":"This coupon is not available for this store, channel, or product."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e5fbaeb9-73b3-4320-8dec-e2c171b31efa":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"bfa79d19-faf8-4b65-9f12-2bd5b6069d7f":{"url":"https://app.masivo.ai/api/storefront/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"trd","siteName":"Masivo","title":"Request TOTP - Masivo","navMaps":{"firstHrefInVersion":{"v1":{"href":"/api-reference/auth/totp/post","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2025-10-27T15:11:55.496Z","originalFileLocation":"api-reference/auth/totp/post.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=\"Some applications may need customers to authorize other systems on their behalf. With the \u0026#x27;totp\u0026#x27; endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Masivo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_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/trd/IG0U6h8DpJ60Xnom/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Request TOTP - Masivo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Some applications may need customers to authorize other systems on their behalf. With the \u0026#x27;totp\u0026#x27; endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Masivo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.masivo.ai/api-reference/auth/totp/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trd.mintlify.app/_mintlify/api/og/v2?division=Auth\u0026amp;title=Request+TOTP\u0026amp;description=Some+applications+may+need+customers+to+authorize+other+systems+on+their+behalf.+With+the+%27totp%27+endpoint%2C+customers+can+request+a+temporal+code+that+other+syst\u0026amp;theme=8f8d98b752dbc21b97c2a726\u0026amp;signature=503d874a7c866263509ac8d87c55a34cdc922140a1c2d506b34ab1eca3ae21e8\">\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=\"Request TOTP - Masivo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Some applications may need customers to authorize other systems on their behalf. With the \u0026#x27;totp\u0026#x27; endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trd.mintlify.app/_mintlify/api/og/v2?division=Auth\u0026amp;title=Request+TOTP\u0026amp;description=Some+applications+may+need+customers+to+authorize+other+systems+on+their+behalf.+With+the+%27totp%27+endpoint%2C+customers+can+request+a+temporal+code+that+other+syst\u0026amp;theme=8f8d98b752dbc21b97c2a726\u0026amp;signature=503d874a7c866263509ac8d87c55a34cdc922140a1c2d506b34ab1eca3ae21e8\">\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/trd/IG0U6h8DpJ60Xnom/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Masivo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9333ea\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.masivo.ai/api-reference/auth/totp/post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/auth/totp/post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.masivo.ai/#organization\",\"name\":\"Masivo\",\"url\":\"https://docs.masivo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trd/7W_vRQTxJHIpxqe2/logo/light.svg?fit=max\u0026auto=format\u0026n=7W_vRQTxJHIpxqe2\u0026q=85\u0026s=d6c63ec91328f53e2881c4b8c6463002\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.masivo.ai#website\",\"name\":\"Masivo\",\"url\":\"https://docs.masivo.ai\",\"publisher\":{\"@id\":\"https://docs.masivo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.masivo.ai/api-reference/auth/totp/post#webpage\",\"url\":\"https://docs.masivo.ai/api-reference/auth/totp/post\",\"name\":\"Request TOTP\",\"description\":\"Some applications may need customers to authorize other systems on their behalf. With the 'totp' endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.\",\"dateModified\":\"2025-10-27T15:11:55.496Z\",\"isPartOf\":{\"@id\":\"https://docs.masivo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.masivo.ai/api-reference/auth/totp/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.masivo.ai/api-reference/auth/totp/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.masivo.ai/api-reference/auth/authorize/get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Auth\",\"item\":\"https://docs.masivo.ai/api-reference/auth/authorize/get\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Request TOTP\",\"item\":\"https://docs.masivo.ai/api-reference/auth/totp/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.masivo.ai/api-reference/auth/totp/post#apireference\",\"headline\":\"Request TOTP\",\"name\":\"Request TOTP\",\"description\":\"Some applications may need customers to authorize other systems on their behalf. With the 'totp' endpoint, customers can request a temporal code that other systems can use to confirm the customer identity.\",\"url\":\"https://docs.masivo.ai/api-reference/auth/totp/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.masivo.ai/api-reference/auth/totp/post#webpage\"},\"dateModified\":\"2025-10-27T15:11:55.496Z\",\"publisher\":{\"@id\":\"https://docs.masivo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.masivo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Masivo\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Masivo","nav":{"global":{"anchors":[{"anchor":"Roadmap","icon":"map","href":"https://docs.masivo.ai/roadmap"},{"anchor":"Changelog","icon":"rocket","href":"https://docs.masivo.ai/changelog"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/2DgqGUej"}]},"versions":[{"version":"v1","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/overview"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Auth","pages":[{"title":"Authorize","openapi":"GET /auth/authorize","description":"Get an Access token to be able to call the api. This token should be kept secret and not exposed to the client.","href":"/api-reference/auth/authorize/get"},{"title":"Request TOTP","openapi":"POST /auth/totp","href":"/api-reference/auth/totp/post"},{"title":"Verify TOTP","openapi":"GET /auth/totp/verify","description":"Verify the TOTP token, if valid return matching customer","href":"/api-reference/auth/totp/verify/get"}]},{"group":"Brands","pages":[{"title":"Get brands","openapi":"GET /brands","href":"/api-reference/brands/get"}]},{"group":"Platforms","pages":[{"title":"Get platforms","openapi":"GET /platforms","href":"/api-reference/platforms/get"}]},{"group":"Tiers","pages":[{"title":"Get tiers","openapi":"GET /tiers","href":"/api-reference/tiers/get"}]},{"group":"Rewards","pages":[{"title":"Get rewards","openapi":"GET /rewards","href":"/api-reference/rewards/get"},{"title":"Get reward","openapi":"GET /rewards/{id}","href":"/api-reference/rewards/[id]/get"},{"group":"Gift cards","pages":[{"title":"Get customer gift cards","openapi":"GET /customers/{id}/rewards/gift-cards","href":"/api-reference/rewards/gift-cards/get"},{"title":"Redeem gift card","openapi":"Delete /rewards/gift-cards/redeem","href":"/api-reference/rewards/gift-cards/redeem/delete"}]}]},{"group":"Customers","pages":[{"title":"Register customer","openapi":"POST /customers","href":"/api-reference/customers/post"},{"title":"Get customer by document or phone","openapi":"GET /customers","href":"/api-reference/customers/get"},{"title":"Get customer","openapi":"GET /customers/{id}","href":"/api-reference/customers/[id]/get"},{"title":"Update customer","openapi":"PATCH /customers/{id}","href":"/api-reference/customers/[id]/patch"},{"title":"Unregister customer","openapi":"DELETE /customers/{id}","href":"/api-reference/customers/[id]/delete"},{"title":"Update customers in bulk","openapi":"PATCH /customers/bulk","href":"/api-reference/customers/bulk/patch"},{"title":"Get customer consent","openapi":"GET /customers/{id}/consent","href":"/api-reference/customers/[id]/consent/get"},{"title":"Update customer consent","openapi":"PATCH /customers/{id}/consent","href":"/api-reference/customers/[id]/consent/patch"},{"title":"Update customer tags","openapi":"PATCH /customers/{id}/tags","href":"/api-reference/customers/[id]/tags/patch"},{"title":"Delete customer tags","openapi":"DELETE /customers/{id}/tags","href":"/api-reference/customers/[id]/tags/delete"},{"title":"Get customer punch-cards","openapi":"GET /customers/{id}/punch-cards","href":"/api-reference/customers/[id]/punch-cards/get"},{"title":"Get customer score streaks","openapi":"GET /customers/{id}/score-streaks","href":"/api-reference/customers/[id]/score-streaks/get"},{"title":"List in-app messages","openapi":"GET /customers/{id}/inapp-messages","href":"/api-reference/customers/[id]/inapp-messages/get"},{"title":"Log in-app message event","openapi":"POST /customers/{id}/inapp-messages/{messageId}/events","href":"/api-reference/customers/[id]/inapp-messages/[messageId]/events/post"},{"title":"Get customer news feed cards","openapi":"GET /customers/{id}/news-feed","href":"/api-reference/customers/[id]/news-feed/get"},{"title":"Log a news feed card event","openapi":"POST /customers/{id}/news-feed/{templateId}/events","href":"/api-reference/customers/[id]/news-feed/[templateId]/events/post"},{"title":"Identify anonymous customers","openapi":"PATCH /customers/{id}/identify/anonymous","href":"/api-reference/customers/[id]/identify/anonymous/patch"}]},{"group":"Contacts","pages":[{"title":"Search contacts","openapi":"GET /contacts","href":"/api-reference/contacts/get"},{"title":"Create contact","openapi":"POST /contacts","href":"/api-reference/contacts/post"},{"title":"Update contact by ID","openapi":"PUT /contacts/{id}","href":"/api-reference/contacts/[id]/put"},{"title":"Delete contact by ID","openapi":"DELETE /contacts/{id}","href":"/api-reference/contacts/[id]/delete"},{"title":"Migrate contacts","openapi":"POST /contacts/migrate","href":"/api-reference/contacts/migrate/post"}]},{"group":"Campaigns","pages":[{"group":"Behavior","pages":[{"title":"Emit event","openapi":"POST /behavior/events","href":"/api-reference/behavior/events/post"},{"title":"Fulfill event","openapi":"PATCH /behavior/events/{eventId}/fulfill","href":"/api-reference/behavior/events/[eventId]/fulfill/patch"},{"title":"Reverse event","openapi":"POST /behavior/events/{eventId}/reverse","href":"/api-reference/behavior/events/[eventId]/reverse/delete"},{"title":"Preview order","openapi":"PUT /events/redeem/preview","href":"/api-reference/events/redeem/preview/put"},{"title":"Identify customer","openapi":"PATCH /events/identify","href":"/api-reference/events/identify/patch"}]},{"group":"Coupons","pages":[{"title":"Redeem coupon","openapi":"POST /coupons/redeem","href":"/api-reference/coupons/redeem/post"},{"title":"Reverse coupon","openapi":"POST /coupons/reverse","href":"/api-reference/coupons/reverse/post"}]},{"group":"Referrals","pages":[{"title":"Request referral code","openapi":"POST /customers/{id}/referrals/request-code","href":"/api-reference/customers/[id]/referrals/request-code/post"}]},{"title":"Get campaign","openapi":"GET /campaigns/{id}","href":"/api-reference/campaigns/[id]/get"},{"title":"Update campaign","openapi":"PUT /campaigns/{id}","href":"/api-reference/campaigns/[id]/put"},{"title":"Get campaigns","openapi":"GET /campaigns","href":"/api-reference/campaigns/get"},{"title":"Create a new campaign","openapi":"POST /campaigns","href":"/api-reference/campaigns/post"}]},{"group":"Review forms","pages":[{"title":"Get form","openapi":"GET /review-forms/{id}","href":"/api-reference/review-forms/[id]/get"},{"title":"Create review","openapi":"POST /review-forms/{id}/reviews","href":"/api-reference/review-forms/[id]/reviews/post"},{"title":"List reviews","openapi":"GET /reviews","href":"/api-reference/reviews/get"}]},{"group":"Tickets","pages":[{"title":"List ticket pipelines","openapi":"GET /ticket-pipelines","href":"/api-reference/ticket-pipelines/get"},{"title":"List ticket closure forms","openapi":"GET /ticket-closure-forms","href":"/api-reference/ticket-closure-forms/get"},{"title":"Create ticket","openapi":"POST /tickets","href":"/api-reference/tickets/post"},{"title":"Get ticket","openapi":"GET /tickets/{id}","href":"/api-reference/tickets/[id]/get"},{"title":"Update ticket","openapi":"PATCH /tickets/{id}","href":"/api-reference/tickets/[id]/patch"},{"title":"List ticket assignees","openapi":"GET /tickets/{id}/assignees","href":"/api-reference/tickets/[id]/assignees/get"},{"title":"Add ticket assignee","openapi":"POST /tickets/{id}/assignees","href":"/api-reference/tickets/[id]/assignees/post"},{"title":"Remove ticket assignee","openapi":"DELETE /tickets/{id}/assignees","href":"/api-reference/tickets/[id]/assignees/delete"},{"title":"List communication threads","openapi":"GET /communication/threads","href":"/api-reference/communication/threads/get"},{"title":"Create communication thread","openapi":"POST /communication/threads","href":"/api-reference/communication/threads/post"},{"title":"Get communication thread","openapi":"GET /communication/threads/{id}","href":"/api-reference/communication/threads/[id]/get"},{"title":"List communication messages","openapi":"GET /communication/threads/{id}/messages","href":"/api-reference/communication/threads/[id]/messages/get"},{"title":"Create communication message","openapi":"POST /communication/threads/{id}/messages","href":"/api-reference/communication/threads/[id]/messages/post"}]},{"group":"Transactions","pages":[{"title":"Customer transactions","openapi":"GET /customers/{id}/transactions","href":"/api-reference/customers/[id]/transactions/get"},{"title":"Account transactions","openapi":"GET /transactions","href":"/api-reference/transactions/get"}]},{"group":"Push","pages":[{"title":"Customer device token","openapi":"PATCH /customers/{id}/devices","href":"/api-reference/customers/[id]/devices/patch"},{"title":"Customer device token","openapi":"DELETE /customers/{id}/devices","href":"/api-reference/customers/[id]/devices/delete"},{"title":"Send customer push","openapi":"POST /push/customers/{id}/send","href":"/api-reference/push/customers/[id]/send/post"},{"title":"Schedule audience push","openapi":"POST /push/audiences/{id}/schedule","href":"/api-reference/push/audiences/[id]/schedule/post"}]},{"group":"In-app","pages":[{"title":"Get in-app capabilities","openapi":"GET /inapp/capabilities","href":"/api-reference/inapp/capabilities/get"}]},{"group":"Migrate","pages":[{"title":"Migrate customers","openapi":"POST /customers/migrate","href":"/api-reference/customers/migrate/post"},{"title":"Migrate devices tokens","openapi":"POST /customers/migrate/devices","href":"/api-reference/customers/migrate/devices/post"},{"title":"Migrate events","openapi":"POST /customers/migrate/events","href":"/api-reference/customers/migrate/events/post"},{"title":"Migrate transactions","openapi":"POST /customers/migrate/transactions","href":"/api-reference/customers/migrate/transactions/post"},{"title":"Revert migration","openapi":"DELETE /customers/migrate/revert","href":"/api-reference/customers/migrate/revert/delete"}]},{"group":"Maintenance","pages":[{"title":"Fulfill expired events","openapi":"POST /customers/fulfill_expired_events","href":"/api-reference/customers/fulfill_expired_events/post"}]}]},{"group":"Guides","pages":[{"title":"Integrate with Masivo","href":"/api-reference/guides/integrate-with-masivo"},{"title":"Register a customer","href":"/api-reference/guides/register-a-customer"},{"title":"Show customer data","href":"/api-reference/guides/show-customer-data"},{"title":"Validate rewards redemption","href":"/api-reference/guides/validate-rewards-redemption"},{"title":"Send an event","href":"/api-reference/guides/send-an-event"},{"title":"Submit reviews","href":"/api-reference/guides/submit-reviews"},{"title":"Redeem a coupon","href":"/api-reference/guides/redeem-a-coupon"},{"title":"Reverse a coupon","href":"/api-reference/guides/reverse-a-coupon"},{"title":"Modify customer balance arbitrarily","href":"/api-reference/guides/modify-customer-balance-arbitrarily"},{"title":"Migrate customers","href":"/api-reference/guides/migrate-customers"},{"title":"Setup webhooks","href":"/api-reference/guides/setup-webhooks"},{"title":"Integrate push notifications","href":"/api-reference/guides/integrate-push-notification"},{"title":"Integrate in-app messages","href":"/api-reference/guides/integrate-in-app-messages"},{"title":"Integrate deferred deep linking","href":"/api-reference/guides/integrate-deferred-deep-linking"},{"group":"Marketing automation","pages":[{"title":"FCM Token Management","href":"/api-reference/guides/fcm-token-management"},{"title":"Attribution Tracking","href":"/api-reference/guides/attribution-tracking"},{"title":"Customer Audience Enrollment","href":"/api-reference/guides/customer-audience-enrollment"},{"title":"Journey Triggers","href":"/api-reference/guides/journey-triggers"}]}]},{"group":"Resources","pages":[{"title":"Resource limits","href":"/api-reference/resources/resource-limits"}]}]}]}]},"title":"Request TOTP - Masivo","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}