Identify and update company profiles in real time or in bulk using Userpilot’s HTTP API.
The Identify Company API allows you to create or update company profiles in real time, either individually or in bulk. Use this API to keep your company data in sync with Userpilot for analytics, segmentation, and B2B engagement.
PII Data NoticeBefore passing any Personally Identifiable Information (PII) such as names, emails, or other sensitive user data to Userpilot:
Security & Compliance: Verify internally with your legal, security, and compliance teams that doing so aligns with your organization’s data privacy policies and applicable regulations (e.g., GDPR, CCPA).
Data Type Mapping: Ensure correct data type mapping for all properties. Userpilot supports String, Numeric, and Date types. Make sure dates are in ISO8601 format and numeric values are properly formatted. Incorrect type mapping can cause issues with segmentation, analytics, and debugging.
Debugging: Proper data formatting is crucial for effective debugging and troubleshooting. Verify that your data maps correctly to Userpilot’s expected formats before implementation.
For bulk company identification and updates, see the dedicated documentation:Bulk Identify Companies - For bulk company operationsThese articles provide comprehensive details on endpoints, authentication, request/response examples, limitations, best practices, and troubleshooting for large-scale data synchronization.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Userpilot Knowledge Base","colors":{"primary":"#6765e8","light":"#9a98f0","dark":"#343374"},"logo":{"light":"https://mintcdn.com/userpilot/KtUQBkEo7Hf3bjCu/up-logo-dark.svg?fit=max\u0026auto=format\u0026n=KtUQBkEo7Hf3bjCu\u0026q=85\u0026s=ed5988b05e17770537d7327506be349c","dark":"https://mintcdn.com/userpilot/KtUQBkEo7Hf3bjCu/up-logo-light.svg?fit=max\u0026auto=format\u0026n=KtUQBkEo7Hf3bjCu\u0026q=85\u0026s=2558daac7455ff6275b45a01cecb8ca9"},"favicon":"https://mintcdn.com/userpilot/KtUQBkEo7Hf3bjCu/up-favicon.svg?fit=max\u0026auto=format\u0026n=KtUQBkEo7Hf3bjCu\u0026q=85\u0026s=bd3fb42ae91a32d13d543fed45a8b88e","footer":{"socials":{"twitter":"https://linkedin.com/company/teamuserpilot","facebook":"https://facebook.com/userpilot","linkedin":"https://linkedin.com/company/teamuserpilot"},"links":[{"header":"Support","items":[{"label":"support@userpilot.com","href":"mailto:support@userpilot.com"}]}]},"seo":{"metatags":{"canonical":"https://docs.userpilot.com","og:site_name":"Userpilot Knowledge Base","og:type":"website","og:image":"https://docs.userpilot.com/up-logo-dark.svg","twitter:card":"summary_large_image","twitter:site":"@usaborpilot"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"userpilot","hasAudioNarration":false,"actualSubdomain":"userpilot","customDomains":["docs.userpilot.com"],"gitSource":{"type":"github","owner":"userpilot","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae0b2192ea1296893eaac7f","collectionId":"fc844142-bc45-4b7f-9358-b6510c66635c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae0b2192ea1296893eaac7f"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae0b2192ea1296893eaac7f","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Platform","count":137},{"language":"default","tag":"Developer","count":88},{"language":"default","tag":"Installation","count":76},{"language":"default","tag":"Mobile","count":68},{"language":"default","tag":"In App Engagement","count":56},{"language":"default","tag":"APIs","count":42},{"language":"default","tag":"Configure","count":23},{"language":"default","tag":"Endpoints","count":20},{"language":"default","tag":"Bulk Export","count":17},{"language":"default","tag":"Integrations","count":14}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--primary:103 101 232;--primary-light:225 224 250;--primary-dark:103 101 232;--background-light:255 255 255;--background-dark:9 13 13;--gray-50:243 247 246;--gray-100:238 242 241;--gray-200:222 226 226;--gray-300:206 210 209;--gray-400:158 163 162;--gray-500:112 116 115;--gray-600:80 84 83;--gray-700:62 67 66;--gray-800:37 41 40;--gray-900:23 27 26;--gray-950:10 14 13;--header:128 127 236;--hover-btn:52 51 116;--accent:103 101 232}header#header>div>div{color:rgb(var(--header))}body :is(.dark\\:bg-primary-light:is(.dark *)){background:rgb(var(--accent))}body :is(.dark\\:bg-primary-light\\/10:is(.dark *)){background:rgb(var(--hover-btn))}"}],"page":{"pagePath":"api-references/real-time/identify-company","slug":"/api-references/real-time/identify-company","pageMetadata":{"title":"Identify Company","description":"Identify and update company profiles in real time or in bulk using Userpilot's HTTP API.","keywords":["Userpilot","Identify","Company","API"],"href":"/api-references/real-time/identify-company"},"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: \"Identify and update company profiles in real time or in bulk using Userpilot’s HTTP API.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The Identify Company API allows you to create or update company profiles in real time, either individually or in bulk. Use this API to keep your company data in sync with Userpilot for analytics, segmentation, and B2B engagement.`}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`PII Data Notice`})}),_jsx(_components.p,{children:`Before passing any Personally Identifiable Information (PII) such as names, emails, or other sensitive user data to Userpilot:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Security \u0026 Compliance:`}),` Verify internally with your legal, security, and compliance teams that doing so aligns with your organization’s data privacy policies and applicable regulations (e.g., GDPR, CCPA).`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Data Type Mapping:`}),` Ensure correct data type mapping for all properties. Userpilot supports String, Numeric, and Date types. Make sure dates are in ISO8601 format and numeric values are properly formatted. Incorrect type mapping can cause issues with segmentation, analytics, and debugging.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Debugging:`}),` Proper data formatting is crucial for effective debugging and troubleshooting. Verify that your data maps correctly to Userpilot’s expected formats before implementation.`]}),`\n`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`individual-identify`,children:`Individual Identify`}),`\n`,_jsx(Heading,{level:`3`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] https:`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`//analytex.userpilot.io/v1/companies/identify`})]}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The endpoint URL uses the `,_jsx(_components.code,{children:`analytex`}),` environment. For EU data residency, use\n`,_jsx(_components.code,{children:`analytex-eu`}),` instead. See `,_jsx(_components.a,{href:`https://run.userpilot.io/environment`,children:`Environment\nSettings`}),` for your specific endpoint.`]})}),`\n`,` `,`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Token {YOUR_API_KEY}`})}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Accept`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json, text/plain, */*`})}),_jsx(_components.td,{children:`Yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`company_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Unique identifier for the company`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metadata`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Key-value pairs describing the company (e.g., name, industry, etc.)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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:` \"company_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"company_001\"`}),_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:` \"metadata\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Corporation\"`}),_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:` \"industry\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SaaS\"`}),_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:` \"plan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Enterprise\"`}),_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:` \"monthly_spend\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`A successful identification returns HTTP status code 200 OK.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`company_id`}),` field is required. Metadata values must be primitive types (string, number, boolean, null).`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`bulk-operations`,children:`Bulk Operations`}),`\n`,_jsx(_components.p,{children:`For bulk company identification and updates, see the dedicated documentation:`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://docs.userpilot.com/api-references/bulk-updates/companies#bulk-identify-update-companies`,children:_jsx(_components.strong,{children:`Bulk Identify Companies`})}),` - For bulk company operations`]}),`\n`,_jsx(_components.p,{children:`These articles provide comprehensive details on endpoints, authentication, request/response examples, limitations, best practices, and troubleshooting for large-scale data synchronization.`}),`\n`,_jsx(_components.hr,{})]})}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":"Identify Company","description":"Identify and update company profiles in real time or in bulk using Userpilot's HTTP API.","keywords":["Userpilot","Identify","Company","API"],"href":"/api-references/real-time/identify-company"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Individual Identify","slug":"individual-identify","depth":2,"children":[{"title":"Endpoint","slug":"endpoint","depth":3,"children":[]},{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Request Body","slug":"request-body","depth":3,"children":[]},{"title":"Example","slug":"example","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}]},{"title":"Bulk Operations","slug":"bulk-operations","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/userpilot/3ace2e9458eac66f/.prettierrc.js","/_mintlify/custom/userpilot/27d7e6557bc674e7/plausible.js","/_mintlify/custom/userpilot/222114e09e9d43ba/scripts/generate-kb-manifest.js","/_mintlify/custom/userpilot/7588c52f105b4ce6/scripts/check-nav.js","/_mintlify/custom/userpilot/77c4aabf1776912c/scripts/check-redirects.js","/_mintlify/custom/userpilot/c4efe6226e95d900/scripts/lib/docs-lib.js","/_mintlify/custom/userpilot/8278790c2c1428e5/scripts/precommit.js","/_mintlify/custom/userpilot/826df8c2727af7c1/scripts/seo-audit.js"],"subdomain":"userpilot","siteName":"Userpilot Knowledge Base","title":"Identify Company - Userpilot Knowledge Base","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T20:58:49.765Z","originalFileLocation":"api-references/real-time/identify-company.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=\"Identify and update company profiles in real time or in bulk using Userpilot\u0026#x27;s HTTP API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Userpilot Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_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/userpilot/aR1cLyV1TsYivBqB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Identify Company - Userpilot Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"Identify and update company profiles in real time or in bulk using Userpilot\u0026#x27;s HTTP API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Userpilot Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.userpilot.com/api-references/real-time/identify-company\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.userpilot.com/up-logo-dark.svg\">\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=\"Identify Company - Userpilot Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Identify and update company profiles in real time or in bulk using Userpilot\u0026#x27;s HTTP API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.userpilot.com/up-logo-dark.svg\">\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/userpilot/aR1cLyV1TsYivBqB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Userpilot Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6765e8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.userpilot.com/api-references/real-time/identify-company\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-references/real-time/identify-company.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.userpilot.com/#organization\",\"name\":\"Userpilot Knowledge Base\",\"url\":\"https://docs.userpilot.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/userpilot/KtUQBkEo7Hf3bjCu/up-logo-dark.svg?fit=max\u0026auto=format\u0026n=KtUQBkEo7Hf3bjCu\u0026q=85\u0026s=ed5988b05e17770537d7327506be349c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.userpilot.com#website\",\"name\":\"Userpilot Knowledge Base\",\"url\":\"https://docs.userpilot.com\",\"publisher\":{\"@id\":\"https://docs.userpilot.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.userpilot.com/api-references/real-time/identify-company#webpage\",\"url\":\"https://docs.userpilot.com/api-references/real-time/identify-company\",\"name\":\"Identify Company\",\"description\":\"Identify and update company profiles in real time or in bulk using Userpilot's HTTP API.\",\"dateModified\":\"2026-09-28T20:58:49.765Z\",\"isPartOf\":{\"@id\":\"https://docs.userpilot.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.userpilot.com/api-references/real-time/identify-company#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.userpilot.com/api-references/real-time/identify-company#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Real-time HTTP\",\"item\":\"https://docs.userpilot.com/api-references/real-time/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Identify Company\",\"item\":\"https://docs.userpilot.com/api-references/real-time/identify-company\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.userpilot.com/api-references/real-time/identify-company#article\",\"headline\":\"Identify Company\",\"name\":\"Identify Company\",\"description\":\"Identify and update company profiles in real time or in bulk using Userpilot's HTTP API.\",\"url\":\"https://docs.userpilot.com/api-references/real-time/identify-company\",\"mainEntityOfPage\":{\"@id\":\"https://docs.userpilot.com/api-references/real-time/identify-company#webpage\"},\"image\":\"https://docs.userpilot.com/up-logo-dark.svg\",\"dateModified\":\"2026-09-28T20:58:49.765Z\",\"keywords\":\"Userpilot, Identify, Company, API\",\"publisher\":{\"@id\":\"https://docs.userpilot.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.userpilot.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Userpilot Knowledge Base\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Userpilot Knowledge Base","nav":{"global":null,"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":"/getting-started/what-is-userpilot"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Developer","pages":[{"title":"Developer","href":"/developer/installation/web"}]},{"tab":"APIs","groups":[{"group":"APIs","icon":"rectangle-terminal","pages":[{"title":"Userpilot API Documentation","sidebarTitle":"Overview","mode":"wide","href":"/api-references/overview"},{"title":"Authentication","href":"/api-references/authentication"},{"title":"Environment","href":"/api-references/environment"}]},{"group":"Real-time HTTP","pages":[{"title":"Overview","href":"/api-references/real-time/overview"},{"title":"Identify User","description":"The Identify User API allows you to create or update user profiles in real time, either individually or in bulk. Use this API to keep your user data in sync with Userpilot for analytics, segmentation, and personalized experiences.","href":"/api-references/real-time/identify-user"},{"title":"Identify Company","href":"/api-references/real-time/identify-company"},{"title":"Track Event","description":"Record custom user events in real time with Userpilot's Track Event HTTP API to power analytics, segmentation, and personalized experiences.","href":"/api-references/real-time/track-event"},{"group":"Endpoints","pages":[{"title":"Identify User","openapi":"POST /v1/identify","href":"/api-references/endpoints/realtime/identify-user"},{"title":"Identify Company","openapi":"POST /v1/companies/identify","href":"/api-references/endpoints/realtime/identify-company"},{"title":"Track Event","openapi":"POST /v1/track","href":"/api-references/endpoints/realtime/track-event"}]}]},{"group":"Bulk Identify/Update","pages":[{"title":"Bulk Identify/Update Users","sidebarTitle":"Users","href":"/api-references/bulk-updates/users"},{"title":"Bulk Identify/Update Companies","sidebarTitle":"Companies","href":"/api-references/bulk-updates/companies"},{"group":"Endpoints","pages":[{"title":"Bulk Users Update","sidebarTitle":"Users","openapi":"POST /v1/users/bulk_identify","href":"/api-references/endpoints/bulk/users"},{"title":"Bulk Companies Update","sidebarTitle":"Companies","openapi":"POST /v1/companies/bulk_identify","href":"/api-references/endpoints/bulk/companies"},{"title":"List Jobs","openapi":"GET /v1/background_jobs","href":"/api-references/endpoints/jobs/list"},{"title":"View Job ID","openapi":"GET /v1/background_jobs/{{job_id}}","href":"/api-references/endpoints/jobs/job-id"}]}]},{"group":"Bulk Import","pages":[{"title":"Events Bulk Import","sidebarTitle":"Overview","href":"/api-references/import/overview"},{"title":"Event Schema","href":"/api-references/import/event-schema"},{"title":"Row Validation Rules","href":"/api-references/import/row-validation"},{"title":"User \u0026 Company Accumulative Properties Best Practices","sidebarTitle":"Best Practices","href":"/api-references/import/best-practices"},{"group":"Endpoints","pages":[{"title":"Import Job","openapi":"POST /v1/imports","href":"/api-references/endpoints/import/import-job"},{"title":"List Jobs","openapi":"GET /v1/background_jobs","href":"/api-references/endpoints/jobs/list"},{"title":"View Job ID","openapi":"GET /v1/background_jobs/{{job_id}}","href":"/api-references/endpoints/jobs/job-id"}]}]},{"group":"Bulk Export","pages":[{"title":"Bulk Data Export API","sidebarTitle":"Overview","href":"/api-references/export/overview"},{"title":"Event Schema","sidebarTitle":"Event Schema","href":"/api-references/export/event-schema"},{"title":"Data Lookups","sidebarTitle":"Data Lookups","href":"/api-references/export/lookups"},{"group":"Endpoints","pages":[{"title":"Export Job","sidebarTitle":"Export Job","openapi":"POST /api/v1/analytics/exports","href":"/api-references/endpoints/export/export-job"},{"title":"List Jobs","openapi":"GET /v1/background_jobs","href":"/api-references/endpoints/jobs/list"},{"title":"View Job ID","openapi":"GET /v1/background_jobs/{{job_id}}","href":"/api-references/endpoints/jobs/job-id"},{"group":"Lookups","pages":[{"title":"User Properties","sidebarTitle":"User Properties","openapi":"GET /api/v1/analytics/exports/lookups/user_properties","href":"/api-references/endpoints/lookups/user-properties"},{"title":"Company Properties","sidebarTitle":"Company Properties","openapi":"GET /api/v1/analytics/exports/lookups/company_properties","href":"/api-references/endpoints/lookups/company-properties"},{"title":"Segments","sidebarTitle":"Segments","openapi":"GET /api/v1/analytics/exports/lookups/segments","href":"/api-references/endpoints/lookups/segments"},{"title":"Features \u0026 Events","sidebarTitle":"Features \u0026 Events","openapi":"GET /api/v1/analytics/exports/lookups/features_events","href":"/api-references/endpoints/lookups/features-events"},{"title":"Flows","sidebarTitle":"Flows","openapi":"GET /api/v1/analytics/exports/lookups/flows","href":"/api-references/endpoints/lookups/flows"},{"title":"Banners","sidebarTitle":"Banners","openapi":"GET /api/v1/analytics/exports/lookups/banners","href":"/api-references/endpoints/lookups/banners"},{"title":"Embeds","sidebarTitle":"Embeds","openapi":"GET /api/v1/analytics/exports/lookups/embeds","href":"/api-references/endpoints/lookups/embeds"},{"title":"Spotlights","sidebarTitle":"Spotlights","openapi":"GET /api/v1/analytics/exports/lookups/spotlights","href":"/api-references/endpoints/lookups/spotlights"},{"title":"Checklists","sidebarTitle":"Checklists","openapi":"GET /api/v1/analytics/exports/lookups/checklists","href":"/api-references/endpoints/lookups/checklists"},{"title":"Surveys","sidebarTitle":"Surveys","openapi":"GET /api/v1/analytics/exports/lookups/surveys","href":"/api-references/endpoints/lookups/surveys"},{"title":"Resource Center Modules","sidebarTitle":"Resource Center Modules","openapi":"GET /api/v1/analytics/exports/lookups/resource_center_modules","href":"/api-references/endpoints/lookups/resource-center-modules"}]}]}]},{"group":"Email Subscriptions","pages":[{"title":"List Subscription Topics","href":"/api-references/email-subscriptions/list-topics"},{"title":"Set Subscription Preferences","href":"/api-references/email-subscriptions/set-preferences"}]},{"group":"Bulk Delete","pages":[{"title":"Delete Users and Companies","sidebarTitle":"Overview","href":"/api-references/delete/overview"}]}]}]},"basePath":"","title":"Identify Company - Userpilot Knowledge Base","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}
