The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dittofeed","colors":{"primary":"#FF8101","light":"#FFDA71","dark":"#FF8101"},"logo":{"light":"https://mintcdn.com/dittofeed/abmbv2I9puhRd1Zb/logo/light.png?fit=max\u0026auto=format\u0026n=abmbv2I9puhRd1Zb\u0026q=85\u0026s=bdd0cf89297f94a24d09411bb12cea58","dark":"https://mintcdn.com/dittofeed/abmbv2I9puhRd1Zb/logo/dark.png?fit=max\u0026auto=format\u0026n=abmbv2I9puhRd1Zb\u0026q=85\u0026s=bc60648977c0f46358a8dce1c687e3b1","href":"https://dittofeed.com"},"favicon":"/favicon_1.png","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"key","name":"Authorization"},"server":"http://localhost:3001"}},"navbar":{"links":[{"label":"Community","href":"https://discord.gg/HajPkCG4Mm"}],"primary":{"type":"github","href":"https://github.com/dittofeed/dittofeed"}},"footer":{"socials":{"twitter":"https://twitter.com/dittofeed","github":"https://github.com/dittofeed/dittofeed","linkedin":"https://www.linkedin.com/company/dittofeed"}},"integrations":{"posthog":{"apiKey":"phc_nAONMdL3n31UGZLr5QmIpPlyHqHV327DgxPCRjMusrG"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Get Instant Help","icon":"discord","href":"https://discord.gg/HajPkCG4Mm"},{"anchor":"Tutorial Videos","icon":"youtube","href":"https://www.youtube.com/@Dittofeed"},{"anchor":"Demo App","icon":"bullseye-pointer","href":"https://demo.dittofeed.com/dashboard/journeys"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dittofeed","hasAudioNarration":false,"actualSubdomain":"dittofeed","customDomains":["docs.dittofeed.com"],"gitSource":{"type":"github","owner":"dittofeed","repo":"dittofeed","deployBranch":"main","contentDirectory":"packages/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c349cf0492c7637e2b41","collectionId":"d3cd599d-7566-4637-ad50-073b413392a4","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a20c349cf0492c7637e2b41:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":108},{"language":"default","tag":"API Reference","count":94},{"language":"default","tag":"Workspace Resources","count":38},{"language":"default","tag":"Deployment","count":26},{"language":"default","tag":"Self-Hosting Options","count":24},{"language":"default","tag":"Integrations","count":22},{"language":"default","tag":"Upgrade Guide","count":14},{"language":"default","tag":"User Guides","count":14},{"language":"default","tag":"Message Channel Types","count":10},{"language":"default","tag":"Segment Nodes","count":10}]},"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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoints/apps/identify","slug":"/api-reference/endpoints/apps/identify","pageMetadata":{"title":"POST /api/public/apps/identify","openapi":"POST /api/public/apps/identify","description":"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.","href":"/api-reference/endpoints/apps/identify"},"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: \"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The following is an example of an identify body.`}),`\n`,_jsx(CodeBlock,{filename:`example body`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"userId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"532\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"traits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[email protected]\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"messageId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6f5f436d-8534-4070-8023-d18f8b78ed39\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"POST /api/public/apps/identify","openapi":"POST /api/public/apps/identify","description":"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.","href":"/api-reference/endpoints/apps/identify"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Public Apps"],"description":"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.","requestBody":"c778a7b7-1500-4c90-a4a3-eee071e98e46","parameters":["652601ae-ef86-4170-baac-46e5837af9c2"],"security":["a4a82f16-5493-4147-ac75-5f29b9482cfb"],"responses":{"204":"129c5661-6201-4e49-91ea-fbdbe3b03efe","401":"2df937bd-517e-4f63-b9d0-1f600e3e9c94"},"method":"post","type":"path","servers":[],"path":"/api/public/apps/identify","baseUrlOptions":["http://localhost:3001"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"652601ae-ef86-4170-baac-46e5837af9c2":{"schema":{"type":"string","isRequired":true,"description":"Authorization header for the request, in the format `Bearer \u003ctoken>`. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.","uniqueKey":"","typeLabel":"string"},"example":"Basic YzQ2MDllYjMtYTE2OC00MGI5LWI1ZWMtYTdiYTFkYzY2NWYwOjI5NGYwYjkyOTI1YWZhNzM=","in":"header","name":"authorization","required":true,"description":"Authorization header for the request, in the format `Bearer \u003ctoken>`. Find your token at https://app.dittofeed.com/dashboard/settings#write-key."}},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["messageId","userId"],"properties":{"messageId":{"description":"Unique identifier for the message, used as an idempotency key for safe retries. Can provide a UUID.","examples":["23d04926-78e5-4ebc-853f-f26c84ff629e"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.messageId","typeLabel":"string"},"userId":{"description":"Unique identifier for the user. Should be the id of the user in your system. Only applicable to logged in users.","examples":["1043","user-123","0a58e5e4-c753-477e-a6c4-f9b0e3396b9b"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.userId","typeLabel":"string"},"timestamp":{"description":"ISO 8601 formatted timestamp of when the event occurred. If not provided, the current server time will be used.","examples":["2024-04-22T07:00:00.000Z"],"type":"string","uniqueKey":"oneOf.0.timestamp","typeLabel":"string"},"context":{"description":"Provides metadata about the user submitting the event and the context in which the event occurred.","examples":[{"ip":"192.0.2.1"}],"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.context.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.0.context","typeLabel":"object"},"traits":{"description":"Free-form dictionary of traits of the user, like email or name. Can contain arbitrary JSON values.","examples":[{"name":"Michael Scott","items":[{"id":1,"name":"Paper"},{"id":2,"name":"Stapler"}]}],"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.traits.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.0.traits","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["messageId","anonymousId"],"properties":{"messageId":{"description":"Unique identifier for the message, used as an idempotency key for safe retries. Can provide a UUID.","examples":["23d04926-78e5-4ebc-853f-f26c84ff629e"],"type":"string","isRequired":true,"uniqueKey":"oneOf.1.messageId","typeLabel":"string"},"anonymousId":{"description":"Identifier for a logged out user. It can be any pseudo-unique identifier, for example a session Id or a UUID.","examples":["0a58e5e4-c753-477e-a6c4-f9b0e3396b9b","session-123"],"type":"string","isRequired":true,"uniqueKey":"oneOf.1.anonymousId","typeLabel":"string"},"timestamp":{"description":"ISO 8601 formatted timestamp of when the event occurred. If not provided, the current server time will be used.","examples":["2024-04-22T07:00:00.000Z"],"type":"string","uniqueKey":"oneOf.1.timestamp","typeLabel":"string"},"context":{"description":"Provides metadata about the user submitting the event and the context in which the event occurred.","examples":[{"ip":"192.0.2.1"}],"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.1.context.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.1.context","typeLabel":"object"},"traits":{"description":"Free-form dictionary of traits of the user, like email or name. Can contain arbitrary JSON values.","examples":[{"name":"Michael Scott","items":[{"id":1,"name":"Paper"},{"id":2,"name":"Stapler"}]}],"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.1.traits.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.1.traits","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"messageId":"23d04926-78e5-4ebc-853f-f26c84ff629e","userId":"1043","timestamp":"2024-04-22T07:00:00.000Z","context":{"ip":"192.0.2.1"},"traits":{"name":"Michael Scott","items":[{"id":1,"name":"Paper"},{"id":2,"name":"Stapler"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"129c5661-6201-4e49-91ea-fbdbe3b03efe":{"description":"An empty String","content":{"application/json":{"schema":{"description":"An empty String","type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"2df937bd-517e-4f63-b9d0-1f600e3e9c94":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a4a82f16-5493-4147-ac75-5f29b9482cfb":{"publicWriteKey":{"type":"apiKey","description":"Authorization header for the request, in the format `Bearer \u003ctoken>`. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.","name":"PublicWriteKey","in":"header","scopes":[]}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Authorization header for the request, in the format `Bearer \u003ctoken>`. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.","name":"PublicWriteKey","in":"header","scopes":[]},"schema":{"title":"PublicWriteKey","type":"string","description":"Authorization header for the request, in the format `Bearer \u003ctoken>`. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"publicWriteKey","name":"PublicWriteKey"}],"title":"publicWriteKey"}]},"originalFileLocation":"open-api.json"},"subdomain":"dittofeed","siteName":"Dittofeed","title":"POST /api/public/apps/identify - Dittofeed","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-12-03T21:41:11.612Z","originalFileLocation":"api-reference/endpoints/apps/identify.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=\"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dittofeed\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_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/dittofeed/WmOcDbx6WUy8pMCI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"POST /api/public/apps/identify - Dittofeed\">\u003cmeta data-mint-head property=\"og:description\" content=\"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dittofeed\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dittofeed.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=POST+%2Fapi%2Fpublic%2Fapps%2Fidentify\u0026amp;description=The+Identify+call+lets+you+tie+a+user+to+their+actions+and+record+traits+about+them.+It+includes+a+unique+User+ID+and+any+optional+traits+you+know+about+the+use\u0026amp;theme=c297dfe8c764693da552b860\u0026amp;signature=82b3f5eaa540223226df55f94249d5f87952194cab9658ebf367d11e81346320\">\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=\"POST /api/public/apps/identify - Dittofeed\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dittofeed.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=POST+%2Fapi%2Fpublic%2Fapps%2Fidentify\u0026amp;description=The+Identify+call+lets+you+tie+a+user+to+their+actions+and+record+traits+about+them.+It+includes+a+unique+User+ID+and+any+optional+traits+you+know+about+the+use\u0026amp;theme=c297dfe8c764693da552b860\u0026amp;signature=82b3f5eaa540223226df55f94249d5f87952194cab9658ebf367d11e81346320\">\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/dittofeed/WmOcDbx6WUy8pMCI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dittofeed\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF8101\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints/apps/identify.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dittofeed.com/#organization\",\"name\":\"Dittofeed\",\"url\":\"https://docs.dittofeed.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dittofeed/abmbv2I9puhRd1Zb/logo/light.png?fit=max\u0026auto=format\u0026n=abmbv2I9puhRd1Zb\u0026q=85\u0026s=bdd0cf89297f94a24d09411bb12cea58\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dittofeed.com#website\",\"name\":\"Dittofeed\",\"url\":\"https://docs.dittofeed.com\",\"publisher\":{\"@id\":\"https://docs.dittofeed.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify#webpage\",\"url\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify\",\"name\":\"POST /api/public/apps/identify\",\"description\":\"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.\",\"dateModified\":\"2025-12-03T21:41:11.612Z\",\"isPartOf\":{\"@id\":\"https://docs.dittofeed.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dittofeed\",\"item\":\"https://docs.dittofeed.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"POST /api/public/apps/identify\",\"item\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify#apireference\",\"headline\":\"POST /api/public/apps/identify\",\"name\":\"POST /api/public/apps/identify\",\"description\":\"The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.\",\"url\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dittofeed.com/api-reference/endpoints/apps/identify#webpage\"},\"dateModified\":\"2025-12-03T21:41:11.612Z\",\"publisher\":{\"@id\":\"https://docs.dittofeed.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dittofeed.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dittofeed\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Dittofeed","nav":{"global":{"anchors":[{"anchor":"Get Instant Help","icon":"discord","href":"https://discord.gg/HajPkCG4Mm"},{"anchor":"Tutorial Videos","icon":"youtube","href":"https://www.youtube.com/@Dittofeed"},{"anchor":"Demo App","icon":"bullseye-pointer","href":"https://demo.dittofeed.com/dashboard/journeys"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"POST /api/public/apps/identify","openapi":"POST /api/public/apps/identify","href":"/api-reference/endpoints/apps/identify"},{"title":"POST /api/public/apps/track","openapi":"POST /api/public/apps/track","description":"The Track call is how you record any actions your users perform, along with any properties that describe the action.","href":"/api-reference/endpoints/apps/track"},{"title":"POST /api/public/apps/page","openapi":"POST /api/public/apps/page","href":"/api-reference/endpoints/apps/page"},{"title":"POST /api/public/apps/screen","openapi":"POST /api/public/apps/screen","href":"/api-reference/endpoints/apps/screen"},{"title":"POST /api/public/apps/group","openapi":"post /api/public/apps/group","href":"/api-reference/auto/public-apps/post-apipublicappsgroup"},{"title":"POST /api/public/apps/batch","openapi":"POST /api/public/apps/batch","href":"/api-reference/endpoints/apps/batch"},{"title":"POST /api/public/webhooks/segment","openapi":"POST /api/public/webhooks/segment","href":"/api-reference/endpoints/webhooks/segment"},{"title":"GET /api/admin/content/templates","openapi":"get /api/admin/content/templates","href":"/api-reference/auto/content/get-apiadmincontenttemplates"},{"openapi":"put /api/admin/content/templates","title":"PUT /api/admin/content/templates","href":"/api-reference/auto/content/put-apiadmincontenttemplates"},{"openapi":"delete /api/admin/content/templates","title":"DELETE /api/admin/content/templates","href":"/api-reference/auto/content/delete-apiadmincontenttemplates"},{"title":"POST /api/admin/content/templates/test","openapi":"post /api/admin/content/templates/test","href":"/api-reference/auto/content/post-apiadmincontenttemplatestest"},{"title":"POST /api/admin/content/templates/batch-send","openapi":"post /api/admin/content/templates/batch-send","href":"/api-reference/auto/content/post-apiadmincontenttemplatesbatch-send"},{"title":"GET /api/admin/segments/","openapi":"get /api/admin/segments/","href":"/api-reference/auto/segments/get-apiadminsegments"},{"title":"PUT /api/admin/segments/","openapi":"put /api/admin/segments/","href":"/api-reference/auto/segments/put-apiadminsegments"},{"title":"DELETE /api/admin/segments/","openapi":"delete /api/admin/segments/","href":"/api-reference/auto/segments/delete-apiadminsegments"},{"title":"GET /api/admin/user-properties/","openapi":"get /api/admin/user-properties/","href":"/api-reference/auto/user-properties/get-apiadminuser-properties"},{"title":"PUT /api/admin/user-properties/","openapi":"put /api/admin/user-properties/","href":"/api-reference/auto/user-properties/put-apiadminuser-properties"},{"title":"DELETE /api/admin/user-properties/","openapi":"delete /api/admin/user-properties/","href":"/api-reference/auto/user-properties/delete-apiadminuser-properties"},{"title":"GET /api/admin/journeys/","openapi":"get /api/admin/journeys/","href":"/api-reference/auto/journeys/get-apiadminjourneys"},{"title":"PUT /api/admin/journeys/","openapi":"put /api/admin/journeys/","href":"/api-reference/auto/journeys/put-apiadminjourneys"},{"title":"DELETE /api/admin/journeys/","openapi":"delete /api/admin/journeys/","href":"/api-reference/auto/journeys/delete-apiadminjourneys"},{"title":"PUT /api/public/subscription-management/user-subscriptions","openapi":"PUT /api/public/subscription-management/user-subscriptions","href":"/api-reference/endpoints/subscription-management/user-subscriptions"},{"title":"GET /api/admin/users/subscriptions","openapi":"get /api/admin/users/subscriptions","href":"/api-reference/auto/users/get-apiadminuserssubscriptions"},{"title":"PUT /api/admin/subscription-groups/assignments","openapi":"put /api/admin/subscription-groups/assignments","href":"/api-reference/auto/subscription-groups/put-apiadminsubscription-groupsassignments"},{"title":"GET /api/admin/subscription-groups","openapi":"get /api/admin/subscription-groups/","href":"/api-reference/auto/subscription-groups/get-apiadminsubscription-groups"},{"title":"POST /api/admin/users/","openapi":"POST /api/admin/users/","href":"/api-reference/auto/users/post-apiadminusers"},{"title":"DELETE /api/admin/users/","openapi":"delete /api/admin/users/","href":"/api-reference/auto/users/delete-apiadminusers"},{"title":"GET /api/admin/events/","openapi":"get /api/admin/events/","href":"/api-reference/auto/events/get-apiadminevents"},{"title":"POST /api/admin/broadcasts/execute","openapi":"post /api/admin/broadcasts/execute","href":"/api-reference/auto/broadcasts/post-apiadminbroadcastsexecute"},{"title":"PUT /api-l/admin/workspaces/child","openapi":"put /api-l/admin/workspaces/child","href":"/api-reference/auto/workspace/put-api-ladminworkspaceschild"},{"title":"DELETE /api-l/admin/workspaces","openapi":"delete /api-l/admin/workspaces/","href":"/api-reference/auto/workspace/delete-api-ladminworkspaces"},{"title":"GET /api-l/admin/workspaces/","openapi":"get /api-l/admin/workspaces/","href":"/api-reference/auto/workspace/get-api-ladminworkspaces"},{"title":"POST /api-l/sessions/","openapi":"post /api-l/sessions/","href":"/api-reference/auto/sessions/post-api-lsessions"},{"title":"GET /api/admin/groups/user-groups","openapi":"get /api/admin/groups/user-groups","href":"/api-reference/auto/groups/get-apiadmingroupsuser-groups"},{"title":"GET /api/admin/groups/users","openapi":"get /api/admin/groups/users","href":"/api-reference/auto/groups/get-apiadmingroupsusers"},{"title":"GET /api/admin/deliveries/","openapi":"get /api/admin/deliveries/","href":"/api-reference/auto/deliveries/get-apiadmindeliveries"},{"title":"PUT /api/admin/settings/email-providers","openapi":"put /api/admin/settings/email-providers","href":"/api-reference/auto/settings/put-apiadminsettingsemail-providers"},{"title":"PUT /api/admin/settings/sms-providers","openapi":"put /api/admin/settings/sms-providers","href":"/api-reference/auto/settings/put-apiadminsettingssms-providers"},{"title":"POST /api/admin/segments/manual-segment/update","openapi":"post /api/admin/segments/manual-segment/update","href":"/api-reference/auto/segments/post-apiadminsegmentsmanual-segmentupdate"},{"title":"POST /api/admin/segments/manual-segment/clear","openapi":"post /api/admin/segments/manual-segment/clear","href":"/api-reference/auto/segments/post-apiadminsegmentsmanual-segmentclear"},{"title":"GET /api/admin/segments/manual-segment/status","openapi":"get /api/admin/segments/manual-segment/status","href":"/api-reference/auto/segments/get-apiadminsegmentsmanual-segmentstatus"},{"title":"GET /api/admin/analysis/chart-data","openapi":"get /api/admin/analysis/chart-data","href":"/api-reference/auto/analysis/get-apiadminanalysischart-data"},{"title":"GET /api/admin/analysis/summary","openapi":"get /api/admin/analysis/summary","href":"/api-reference/auto/analysis/get-apiadminanalysissummary"},{"title":"GET /api/admin/analysis/journey-stats","openapi":"get /api/admin/analysis/journey-stats","href":"/api-reference/auto/analysis/get-apiadminanalysisjourney-stats"},{"title":"GET /api/admin/component-configurations/","openapi":"get /api/admin/component-configurations/","href":"/api-reference/auto/componentconfigurations/get-apiadmincomponent-configurations"},{"title":"PUT /api/admin/component-configurations/","openapi":"put /api/admin/component-configurations/","href":"/api-reference/auto/componentconfigurations/put-apiadmincomponent-configurations"},{"title":"DELETE /api/admin/component-configurations/","openapi":"delete /api/admin/component-configurations/","href":"/api-reference/auto/componentconfigurations/delete-apiadmincomponent-configurations"}]}]},{"tab":"Embedded Components","pages":[{"title":"Embedded Components","href":"/embedded/getting-started"}]}]},"basePath":"","title":"POST /api/public/apps/identify - Dittofeed","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}