What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.
HunterAI maps every source into one canonical, source-blind model. Once ingested,
nothing downstream — dashboards, funnels, AI coaching — knows whether a row came from
amoCRM or your custom CRM. This page explains what each entity becomes and the handful of
conventions that apply everywhere.
What HunterAI derives from each entity
Entity
Powers
Pipelines & stages
Funnel structure; the won/lost classification every lead metric depends on.
Users
The roster of CRM managers, and per-manager attribution of leads, tasks, and calls.
Contacts
The people behind leads; contact-level context for analytics.
Leads
The core of revenue, conversion, win-rate, and goal-progress analytics.
Events
Lead history: stage-change timelines, activity reconstruction.
Call volume and connect-rate (a call with duration_seconds > 0 counts as connected).
Conventions that apply everywhere
IDs are strings
Every id you return — and every cross-reference like pipeline_id, stage_id,
responsible_user_id, contact_ids, lead_id — is coerced to a string on ingest. Use
whatever ID scheme you like: numeric, UUID, or prefixed slugs (pipe-sales, stg-won).
The only hard rule: an ID must be stable for the life of the record, because it is half
of the (connection, id) upsert key.
If a record’s id changes between syncs, HunterAI treats it as a new record and the
old one is orphaned. Never recycle or renumber IDs.
Cross-references are by ID, never nested objects
A lead points at its pipeline, stage, owner, and contact by ID. HunterAI resolves the
relationships on its side. You do not embed the full pipeline object inside a lead — you
send pipeline_id, stage_id, responsible_user_id, and contact_ids.
Timestamps are ISO-8601 strings
All timestamps are ISO-8601 strings. Both of these are accepted:
A timestamp with no timezone is interpreted as UTC.
An unparseable timestamp becomes null for that field — it does not reject the
record or fail the page. A nullupdated_at, however, means the record cannot
participate in the watermark, so keep your timestamps valid.
updated_at is load-bearing: it is both the updated_since filter field and the
watermark. See How sync works.
Custom fields
/contacts and /leads accept a flat custom_fields object:
HunterAI stores it as a list of { "name": …, "value": … } pairs. Values may be any JSON
type. Custom fields are retained but are not interpreted by analytics in v1.0.
String fields are truncated, not rejected
Text fields have maximum accepted lengths. A value longer than the limit is silently
truncated to fit — it never rejects the record. The exact limit is listed on each
endpoint page and collected in
Limitations → Truncation.
Raw payloads
For leads, events, and calls, HunterAI keeps your full raw JSON alongside the
mapped columns (useful for later reprocessing). Contacts, users, pipelines, stages, and
tasks do not retain a raw copy — any field on those entities that this spec does not map
is dropped. Don’t rely on sending extra fields on those entities; send what the reference
documents.
Tenancy
A HunterAI business can hold more than one connection. Every ingested row is stamped with
the connection it came from, and that stamp is applied by HunterAI — never trusted from
your payload. Your data is isolated per connection; two connections never see each other’s
rows.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"HunterAI Integration","description":"Connect your CRM to HunterAI by implementing a small, read-only pull API.","colors":{"primary":"#D97757","light":"#E89B82","dark":"#C25E3F"},"logo":{"light":"https://mintcdn.com/hunter-67864d54/1eTc4OS-kcAYmnf7/logo/light.svg?fit=max\u0026auto=format\u0026n=1eTc4OS-kcAYmnf7\u0026q=85\u0026s=da15f7aaae5517f79be5bd3253e00257","dark":"https://mintcdn.com/hunter-67864d54/1eTc4OS-kcAYmnf7/logo/dark.svg?fit=max\u0026auto=format\u0026n=1eTc4OS-kcAYmnf7\u0026q=85\u0026s=0fbea8136705fafd74ee374090accf6a"},"favicon":"https://mintcdn.com/hunter-67864d54/1eTc4OS-kcAYmnf7/favicon.svg?fit=max\u0026auto=format\u0026n=1eTc4OS-kcAYmnf7\u0026q=85\u0026s=2ee0109cc438018421102329096c6fb6","footer":{"socials":{"website":"https://hunterai.uz"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hunter-67864d54","hasAudioNarration":false,"actualSubdomain":"hunter-67864d54","customDomains":["integration.hunterai.uz"],"gitSource":{"type":"github","owner":"aslonbek2001","repo":"hunter-md","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95cb4e1186677be471d1b:success","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Endpoint reference","count":7},{"language":"default","tag":"Limits \u0026 policies","count":4},{"language":"default","tag":"Required endpoints","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Optional endpoints","count":3},{"language":"default","tag":"Operations","count":3},{"language":"default","tag":"Concepts","count":2},{"language":"default","tag":"Go live","count":2},{"language":"default","tag":"Release notes","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"concepts/data-model","slug":"/concepts/data-model","pageMetadata":{"title":"Data model","description":"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.","href":"/concepts/data-model"},"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: \"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.\"\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`,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,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`HunterAI maps every source into one `,_jsx(_components.strong,{children:`canonical, source-blind`}),` model. Once ingested,\nnothing downstream — dashboards, funnels, AI coaching — knows whether a row came from\namoCRM or your custom CRM. This page explains what each entity becomes and the handful of\nconventions that apply everywhere.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-hunterai-derives-from-each-entity`,children:`What HunterAI derives from each entity`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Entity`}),_jsx(_components.th,{children:`Powers`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Pipelines \u0026 stages`})}),_jsx(_components.td,{children:`Funnel structure; the won/lost classification every lead metric depends on.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Users`})}),_jsx(_components.td,{children:`The roster of CRM managers, and per-manager attribution of leads, tasks, and calls.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contacts`})}),_jsx(_components.td,{children:`The people behind leads; contact-level context for analytics.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Leads`})}),_jsx(_components.td,{children:`The core of revenue, conversion, win-rate, and goal-progress analytics.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Events`})}),_jsx(_components.td,{children:`Lead history: stage-change timelines, activity reconstruction.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tasks`})}),_jsx(_components.td,{children:`Manager discipline metrics — overdue, completion, follow-up cadence.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Calls`})}),_jsxs(_components.td,{children:[`Call volume and connect-rate (a call with `,_jsx(_components.code,{children:`duration_seconds > 0`}),` counts as connected).`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`conventions-that-apply-everywhere`,children:`Conventions that apply everywhere`}),`\n`,_jsx(Heading,{level:`3`,id:`ids-are-strings`,children:`IDs are strings`}),`\n`,_jsxs(_components.p,{children:[`Every `,_jsx(_components.code,{children:`id`}),` you return — and every cross-reference like `,_jsx(_components.code,{children:`pipeline_id`}),`, `,_jsx(_components.code,{children:`stage_id`}),`,\n`,_jsx(_components.code,{children:`responsible_user_id`}),`, `,_jsx(_components.code,{children:`contact_ids`}),`, `,_jsx(_components.code,{children:`lead_id`}),` — is coerced to a `,_jsx(_components.strong,{children:`string`}),` on ingest. Use\nwhatever ID scheme you like: numeric, UUID, or prefixed slugs (`,_jsx(_components.code,{children:`pipe-sales`}),`, `,_jsx(_components.code,{children:`stg-won`}),`).\nThe only hard rule: an ID must be `,_jsx(_components.strong,{children:`stable`}),` for the life of the record, because it is half\nof the `,_jsx(_components.code,{children:`(connection, id)`}),` upsert key.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`If a record’s `,_jsx(_components.code,{children:`id`}),` changes between syncs, HunterAI treats it as a `,_jsx(_components.strong,{children:`new`}),` record and the\nold one is orphaned. Never recycle or renumber IDs.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`cross-references-are-by-id-never-nested-objects`,children:`Cross-references are by ID, never nested objects`}),`\n`,_jsxs(_components.p,{children:[`A lead points at its pipeline, stage, owner, and contact by `,_jsx(_components.strong,{children:`ID`}),`. HunterAI resolves the\nrelationships on its side. You do not embed the full pipeline object inside a lead — you\nsend `,_jsx(_components.code,{children:`pipeline_id`}),`, `,_jsx(_components.code,{children:`stage_id`}),`, `,_jsx(_components.code,{children:`responsible_user_id`}),`, and `,_jsx(_components.code,{children:`contact_ids`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`timestamps-are-iso-8601-strings`,children:`Timestamps are ISO-8601 strings`}),`\n`,_jsxs(_components.p,{children:[`All timestamps are `,_jsx(_components.strong,{children:`ISO-8601`}),` strings. Both of these are accepted:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2025-07-24T09:30:00Z # UTC, trailing Z`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2025-07-24T09:30:00+05:00 # explicit offset (Uzbekistan is UTC+5)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A timestamp with no timezone is interpreted as `,_jsx(_components.strong,{children:`UTC`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`An `,_jsx(_components.strong,{children:`unparseable`}),` timestamp becomes `,_jsx(_components.code,{children:`null`}),` for that field — it does `,_jsx(_components.strong,{children:`not`}),` reject the\nrecord or fail the page. A `,_jsx(_components.code,{children:`null`}),` `,_jsx(_components.code,{children:`updated_at`}),`, however, means the record cannot\nparticipate in the watermark, so keep your timestamps valid.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`updated_at`}),` is load-bearing: it is both the `,_jsx(_components.code,{children:`updated_since`}),` filter field and the\nwatermark. See `,_jsx(_components.a,{href:`/concepts/how-sync-works#ordering-and-the-watermark`,children:`How sync works`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`custom-fields`,children:`Custom fields`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`/contacts`}),` and `,_jsx(_components.code,{children:`/leads`}),` accept a flat `,_jsx(_components.code,{children:`custom_fields`}),` object:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"custom_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"telegram\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"@aziz\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"region\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Toshkent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`HunterAI stores it as a list of `,_jsx(_components.code,{children:`{ \"name\": …, \"value\": … }`}),` pairs. Values may be any JSON\ntype. Custom fields are retained but are `,_jsx(_components.strong,{children:`not`}),` interpreted by analytics in v1.0.`]}),`\n`,_jsx(Heading,{level:`3`,id:`string-fields-are-truncated-not-rejected`,children:`String fields are truncated, not rejected`}),`\n`,_jsxs(_components.p,{children:[`Text fields have maximum accepted lengths. A value longer than the limit is `,_jsx(_components.strong,{children:`silently\ntruncated`}),` to fit — it never rejects the record. The exact limit is listed on each\n`,_jsx(_components.a,{href:`/endpoints/pipelines`,children:`endpoint page`}),` and collected in\n`,_jsx(_components.a,{href:`/limitations#field-truncation-limits`,children:`Limitations → Truncation`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`raw-payloads`,children:`Raw payloads`}),`\n`,_jsxs(_components.p,{children:[`For `,_jsx(_components.strong,{children:`leads`}),`, `,_jsx(_components.strong,{children:`events`}),`, and `,_jsx(_components.strong,{children:`calls`}),`, HunterAI keeps your full raw JSON alongside the\nmapped columns (useful for later reprocessing). `,_jsx(_components.strong,{children:`Contacts, users, pipelines, stages, and\ntasks do not retain a raw copy`}),` — any field on those entities that this spec does not map\nis dropped. Don’t rely on sending extra fields on those entities; send what the reference\ndocuments.`]}),`\n`,_jsx(Heading,{level:`2`,id:`tenancy`,children:`Tenancy`}),`\n`,_jsxs(_components.p,{children:[`A HunterAI business can hold more than one connection. Every ingested row is stamped with\nthe `,_jsx(_components.strong,{children:`connection`}),` it came from, and that stamp is applied by HunterAI — never trusted from\nyour payload. Your data is isolated per connection; two connections never see each other’s\nrows.`]})]})}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":"Data model","description":"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.","href":"/concepts/data-model"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What HunterAI derives from each entity","slug":"what-hunterai-derives-from-each-entity","depth":2,"children":[]},{"title":"Conventions that apply everywhere","slug":"conventions-that-apply-everywhere","depth":2,"children":[{"title":"IDs are strings","slug":"ids-are-strings","depth":3,"children":[]},{"title":"Cross-references are by ID, never nested objects","slug":"cross-references-are-by-id-never-nested-objects","depth":3,"children":[]},{"title":"Timestamps are ISO-8601 strings","slug":"timestamps-are-iso-8601-strings","depth":3,"children":[]},{"title":"Custom fields","slug":"custom-fields","depth":3,"children":[]},{"title":"String fields are truncated, not rejected","slug":"string-fields-are-truncated-not-rejected","depth":3,"children":[]},{"title":"Raw payloads","slug":"raw-payloads","depth":3,"children":[]}]},{"title":"Tenancy","slug":"tenancy","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"hunter-67864d54","siteName":"HunterAI Integration","title":"Data model - HunterAI Integration","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-28T13:23:04.092Z","originalFileLocation":"concepts/data-model.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=\"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HunterAI Integration\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_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/hunter-67864d54/_yCjAexoStmcCjrX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Data model - HunterAI Integration\">\u003cmeta data-mint-head property=\"og:description\" content=\"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HunterAI Integration\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://integration.hunterai.uz/concepts/data-model\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hunter-67864d54.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Data+model\u0026amp;description=What+HunterAI+derives+from+each+entity%2C+and+how+your+source+IDs%2C+timestamps%2C+and+custom+fields+land+in+the+canonical+model.\u0026amp;theme=da11d5d870f3e521c5dc043c\u0026amp;signature=b00861ce3eaf63eca10291decb6d9fe77482dcba5d7a08f8e2042be4e8bca25e\">\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=\"Data model - HunterAI Integration\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hunter-67864d54.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Data+model\u0026amp;description=What+HunterAI+derives+from+each+entity%2C+and+how+your+source+IDs%2C+timestamps%2C+and+custom+fields+land+in+the+canonical+model.\u0026amp;theme=da11d5d870f3e521c5dc043c\u0026amp;signature=b00861ce3eaf63eca10291decb6d9fe77482dcba5d7a08f8e2042be4e8bca25e\">\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/hunter-67864d54/_yCjAexoStmcCjrX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HunterAI Integration\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#D97757\">\u003clink data-mint-head rel=\"canonical\" href=\"https://integration.hunterai.uz/concepts/data-model\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/data-model.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://integration.hunterai.uz/#organization\",\"name\":\"HunterAI Integration\",\"url\":\"https://integration.hunterai.uz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hunter-67864d54/1eTc4OS-kcAYmnf7/logo/light.svg?fit=max\u0026auto=format\u0026n=1eTc4OS-kcAYmnf7\u0026q=85\u0026s=da15f7aaae5517f79be5bd3253e00257\"}},{\"@type\":\"WebSite\",\"@id\":\"https://integration.hunterai.uz#website\",\"name\":\"HunterAI Integration\",\"url\":\"https://integration.hunterai.uz\",\"publisher\":{\"@id\":\"https://integration.hunterai.uz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://integration.hunterai.uz/concepts/data-model#webpage\",\"url\":\"https://integration.hunterai.uz/concepts/data-model\",\"name\":\"Data model\",\"description\":\"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.\",\"dateModified\":\"2026-07-28T13:23:04.092Z\",\"isPartOf\":{\"@id\":\"https://integration.hunterai.uz#website\"},\"breadcrumb\":{\"@id\":\"https://integration.hunterai.uz/concepts/data-model#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://integration.hunterai.uz/concepts/data-model#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Concepts\",\"item\":\"https://integration.hunterai.uz/concepts/how-sync-works\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Data model\",\"item\":\"https://integration.hunterai.uz/concepts/data-model\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://integration.hunterai.uz/concepts/data-model#article\",\"headline\":\"Data model\",\"name\":\"Data model\",\"description\":\"What HunterAI derives from each entity, and how your source IDs, timestamps, and custom fields land in the canonical model.\",\"url\":\"https://integration.hunterai.uz/concepts/data-model\",\"mainEntityOfPage\":{\"@id\":\"https://integration.hunterai.uz/concepts/data-model#webpage\"},\"dateModified\":\"2026-07-28T13:23:04.092Z\",\"publisher\":{\"@id\":\"https://integration.hunterai.uz/#organization\"},\"isPartOf\":{\"@id\":\"https://integration.hunterai.uz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HunterAI Integration\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"HunterAI Integration\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/concepts/data-model.md","siteName":"HunterAI Integration","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"HunterAI CRM Integration","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"}]},{"group":"Concepts","pages":[{"title":"How sync works","description":"A one-directional pull model: full sync, then incremental by updated_since, terminated by has_more and driven by a per-entity watermark.","href":"/concepts/how-sync-works"},{"title":"Data model","href":"/concepts/data-model"}]},{"group":"Go live","pages":[{"title":"Go live","description":"The end-to-end sequence to connect a custom CRM — who does what, the real HunterAI endpoints, and what does not work yet.","href":"/guides/connecting"},{"title":"Conformance checklist","href":"/guides/conformance-checklist"}]}]},{"tab":"Endpoint reference","pages":[{"title":"Endpoint reference","href":"/endpoints/pipelines"}]},{"tab":"Limits \u0026 policies","pages":[{"title":"Limits \u0026 policies","href":"/errors"}]}]},"basePath":"","title":"Data model - HunterAI Integration","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}