Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.
These are constraints of the canonical model that ingests your data. Each is deliberate;
each has a consequence you should design around. None of them is a bug — they are the shape
of v1.0.
Currency is not stored
A lead’s price is stored as a plain integer with no currency. The currency field you
send is dropped from the mapped columns (it survives only in the raw copy, which analytics
do not read).
Consequence: a connection is effectively single-currency. If your leads mix
currencies, HunterAI sums them as one unit — a 1000 USD lead and a 1000 UZS lead both
count as 1000. Revenue totals, averages, and goal progress will be wrong.Design around it: send price in one consistent currency per connection. If you
operate in several currencies and need correct totals, convert to a single reporting
currency before sending, or raise a multi-currency requirement with HunterAI.
Only the first contact on a lead is kept
contact_ids is an array, but HunterAI keeps only the first element. The rest are
dropped.
Consequence: a multi-contact lead is linked to exactly one contact. Contact-level
analytics see only the primary.Design around it: order contact_ids so the most representative contact is first.
Tombstones apply to leads only
The only delete signal HunterAI honours is a lead’s is_deleted: true. There is no
soft-delete for contacts, users, tasks, or calls — those entities have no deleted flag in
the canonical model.
Consequence: a contact, task, or call you delete in your CRM is still ingested as
active. HunterAI also never removes a row that simply stops appearing in your
responses — the upsert only inserts and updates, never deletes.Design around it: the only deletion you can propagate is a lead via is_deleted. For
everything else, plan for records to persist in HunterAI once synced.
Stage kind must be exactly open, won, or lost
The stage kind on /pipelines
must be one of open, won, or lost (matched case-insensitively). Any other value — or a
missing kind — is rejected as an error: it fails the page and, because /pipelines
is required, fails the sync. It is not silently classified as open.
Consequence: an unrecognised kind is a hard error, not a silent fallback. A stage
that should be “won” but is spelled "win" stops the sync outright — you find out
immediately rather than discovering corrupted win-rate and revenue later.Design around it: validate that every stage emits exactly open, won, or lost
before you request a connection.
Won/lost depends on the stage being synced
A lead’s won/lost is resolved from its stage’s kind, looked up among stages already synced
in the same run.
Consequence: if a lead references a pipeline/stage that was not synced (for example a
partial sync of only leads, or a lead pointing at a stage you did not return on
/pipelines), HunterAI cannot classify it. The lead lands with is_won = is_lost = false.
This is counted and surfaced in the run summary — it is not silent — but the classification
is wrong until the pipelines/stages are present.Design around it: always return every stage a lead can reference on /pipelines, and
let full syncs run all entities.
Fields dropped entirely
Some fields you can send are discarded because the canonical model has no column for them:
Additionally, contacts, users, pipelines, stages, and tasks retain no raw copy — any
field on those entities not listed in the reference is dropped. Only
leads, events, and calls keep your full raw payload for future reprocessing.
Field truncation limits
Over-length text is silently truncated to fit — it never rejects the record. Maximum
accepted lengths:
Accepted formats: exactly the set every endpoint page documents — an explicit offset,
a trailing Z, no zone at all (read as UTC), a T or a single space between date and
time, or a bare date (time becomes 00:00 UTC). See
/leads → Timestamp format for the canonical list;
it is identical on every endpoint page. Prefer the explicit-offset form.
Unparseable value: becomes null for that field. The record is still ingested — a
single bad timestamp does not reject the record or fail the page.
Consequence: a nullupdated_at means the record cannot participate in the
watermark — an incremental sync may
not pick it up correctly. Keep updated_at valid and always advancing on every change.
Managers are not linked to HunterAI logins
CRM managers are ingested and used for attribution, but for a custom source they are not
automatically turned into HunterAI logins. Per-manager dashboards, scoping, and coaching are
unavailable until invitation-based linking ships. This is a deliberate security decision —
see Go live → What does not work yet.
{"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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":"limitations","slug":"/limitations","pageMetadata":{"title":"Limitations","description":"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.","href":"/limitations"},"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: \"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.\"\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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`These are constraints of the canonical model that ingests your data. Each is deliberate;\neach has a consequence you should design around. None of them is a bug — they are the shape\nof v1.0.`}),`\n`,_jsx(Heading,{level:`2`,id:`currency-is-not-stored`,children:`Currency is not stored`}),`\n`,_jsxs(_components.p,{children:[`A lead’s `,_jsx(_components.code,{children:`price`}),` is stored as a `,_jsx(_components.strong,{children:`plain integer with no currency`}),`. The `,_jsx(_components.code,{children:`currency`}),` field you\nsend is dropped from the mapped columns (it survives only in the raw copy, which analytics\ndo not read).`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Consequence:`}),` a connection is effectively `,_jsx(_components.strong,{children:`single-currency`}),`. If your leads mix\ncurrencies, HunterAI sums them as one unit — a `,_jsx(_components.code,{children:`1000`}),` USD lead and a `,_jsx(_components.code,{children:`1000`}),` UZS lead both\ncount as `,_jsx(_components.code,{children:`1000`}),`. Revenue totals, averages, and goal progress will be wrong.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Design around it:`}),` send `,_jsx(_components.code,{children:`price`}),` in one consistent currency per connection. If you\noperate in several currencies and need correct totals, convert to a single reporting\ncurrency before sending, or raise a multi-currency requirement with HunterAI.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`only-the-first-contact-on-a-lead-is-kept`,children:`Only the first contact on a lead is kept`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`contact_ids`}),` is an array, but HunterAI keeps `,_jsx(_components.strong,{children:`only the first element`}),`. The rest are\ndropped.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Consequence:`}),` a multi-contact lead is linked to exactly one contact. Contact-level\nanalytics see only the primary.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Design around it:`}),` order `,_jsx(_components.code,{children:`contact_ids`}),` so the most representative contact is `,_jsx(_components.strong,{children:`first`}),`.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`tombstones-apply-to-leads-only`,children:`Tombstones apply to leads only`}),`\n`,_jsxs(_components.p,{children:[`The only delete signal HunterAI honours is a lead’s `,_jsx(_components.code,{children:`is_deleted: true`}),`. There is `,_jsx(_components.strong,{children:`no\nsoft-delete`}),` for contacts, users, tasks, or calls — those entities have no deleted flag in\nthe canonical model.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Consequence:`}),` a contact, task, or call you delete in your CRM is still ingested as\n`,_jsx(_components.strong,{children:`active`}),`. HunterAI also never removes a row that simply stops appearing in your\nresponses — the upsert only inserts and updates, never deletes.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Design around it:`}),` the only deletion you can propagate is a lead via `,_jsx(_components.code,{children:`is_deleted`}),`. For\neverything else, plan for records to persist in HunterAI once synced.`]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`stage-kind-must-be-exactly-open-won-or-lost`,children:[`Stage `,_jsx(_components.code,{children:`kind`}),` must be exactly `,_jsx(_components.code,{children:`open`}),`, `,_jsx(_components.code,{children:`won`}),`, or `,_jsx(_components.code,{children:`lost`})]}),`\n`,_jsxs(_components.p,{children:[`The stage `,_jsx(_components.code,{children:`kind`}),` on `,_jsx(_components.a,{href:`/endpoints/pipelines#stage-kind-classification`,children:_jsx(_components.code,{children:`/pipelines`})}),`\nmust be one of `,_jsx(_components.code,{children:`open`}),`, `,_jsx(_components.code,{children:`won`}),`, or `,_jsx(_components.code,{children:`lost`}),` (matched case-insensitively). Any other value — or a\nmissing `,_jsx(_components.code,{children:`kind`}),` — is `,_jsx(_components.strong,{children:`rejected as an error`}),`: it fails the page and, because `,_jsx(_components.code,{children:`/pipelines`}),`\nis required, fails the sync. It is `,_jsx(_components.strong,{children:`not`}),` silently classified as `,_jsx(_components.code,{children:`open`}),`.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Consequence:`}),` an unrecognised `,_jsx(_components.code,{children:`kind`}),` is a hard error, not a silent fallback. A stage\nthat should be “won” but is spelled `,_jsx(_components.code,{children:`\"win\"`}),` stops the sync outright — you find out\nimmediately rather than discovering corrupted win-rate and revenue later.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Design around it:`}),` validate that every stage emits exactly `,_jsx(_components.code,{children:`open`}),`, `,_jsx(_components.code,{children:`won`}),`, or `,_jsx(_components.code,{children:`lost`}),`\nbefore you request a connection.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`won/lost-depends-on-the-stage-being-synced`,children:`Won/lost depends on the stage being synced`}),`\n`,_jsxs(_components.p,{children:[`A lead’s won/lost is resolved from its stage’s `,_jsx(_components.code,{children:`kind`}),`, looked up among stages already synced\nin the same run.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Consequence:`}),` if a lead references a pipeline/stage that was not synced (for example a\npartial sync of only `,_jsx(_components.code,{children:`leads`}),`, or a lead pointing at a stage you did not return on\n`,_jsx(_components.code,{children:`/pipelines`}),`), HunterAI cannot classify it. The lead lands with `,_jsx(_components.code,{children:`is_won = is_lost = false`}),`.\nThis is counted and surfaced in the run summary — it is not silent — but the classification\nis wrong until the pipelines/stages are present.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Design around it:`}),` always return every stage a lead can reference on `,_jsx(_components.code,{children:`/pipelines`}),`, and\nlet full syncs run all entities.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`fields-dropped-entirely`,children:`Fields dropped entirely`}),`\n`,_jsx(_components.p,{children:`Some fields you can send are discarded because the canonical model has no column for them:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Entity`}),_jsx(_components.th,{children:`Field(s) dropped`}),_jsx(_components.th,{children:`Note`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`phone`})}),_jsx(_components.td,{children:`No phone column on users.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Leads`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsxs(_components.td,{children:[`See `,_jsx(_components.a,{href:`#currency-is-not-stored`,children:`Currency`}),`. Kept in the raw copy only.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Leads`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_ids[1:]`})}),_jsx(_components.td,{children:`Only the first contact is kept.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Events`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`created_by`})}),_jsx(_components.td,{children:`No actor column on events.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tasks`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`created_at`}),`, and any `,_jsx(_components.code,{children:`task_type`}),` / `,_jsx(_components.code,{children:`duration`}),` / `,_jsx(_components.code,{children:`result`})]}),_jsxs(_components.td,{children:[`Only `,_jsx(_components.code,{children:`updated_at`}),`, `,_jsx(_components.code,{children:`due_at`}),`, `,_jsx(_components.code,{children:`completed_at`}),` are kept.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Calls`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`call_status`}),`, `,_jsx(_components.code,{children:`result`}),`, `,_jsx(_components.code,{children:`recording_link`}),`, `,_jsx(_components.code,{children:`source`}),`, `,_jsx(_components.code,{children:`created_by`})]}),_jsx(_components.td,{children:`Telephony extras; kept in the raw copy only.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Additionally, `,_jsx(_components.strong,{children:`contacts, users, pipelines, stages, and tasks retain no raw copy`}),` — any\nfield on those entities not listed in the `,_jsx(_components.a,{href:`/endpoints/pipelines`,children:`reference`}),` is dropped. Only\n`,_jsx(_components.strong,{children:`leads, events, and calls`}),` keep your full raw payload for future reprocessing.`]}),`\n`,_jsx(Heading,{level:`2`,id:`field-truncation-limits`,children:`Field truncation limits`}),`\n`,_jsxs(_components.p,{children:[`Over-length text is `,_jsx(_components.strong,{children:`silently truncated`}),` to fit — it never rejects the record. Maximum\naccepted lengths:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Max chars`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`pipeline.name`}),`, `,_jsx(_components.code,{children:`stage.name`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`255`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stage.color`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`20`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`user.name`}),`, `,_jsx(_components.code,{children:`user.email`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`255`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`user.role`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`100`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`contact.name`}),`, `,_jsx(_components.code,{children:`contact.email`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`255`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.phone`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`50`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`lead.name`}),`, `,_jsx(_components.code,{children:`lead.source`}),`, `,_jsx(_components.code,{children:`lead.utm.source`}),`, `,_jsx(_components.code,{children:`lead.utm.medium`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`255`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`lead.utm.campaign`}),`, `,_jsx(_components.code,{children:`lead.utm.content`}),`, `,_jsx(_components.code,{children:`lead.utm.term`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`lead.loss_reason`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`event.type`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`100`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`call.phone`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`32`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`task.text`})}),_jsx(_components.td,{children:`unlimited`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`timestamp-handling`,children:`Timestamp handling`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Accepted formats:`}),` exactly the set every endpoint page documents — an explicit offset,\na trailing `,_jsx(_components.code,{children:`Z`}),`, no zone at all (read as UTC), a `,_jsx(_components.code,{children:`T`}),` or a single space between date and\ntime, or a bare date (time becomes `,_jsx(_components.code,{children:`00:00`}),` UTC). See\n`,_jsxs(_components.a,{href:`/endpoints/leads#timestamp-format`,children:[_jsx(_components.code,{children:`/leads`}),` → Timestamp format`]}),` for the canonical list;\nit is identical on every endpoint page. Prefer the explicit-offset form.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unparseable value:`}),` becomes `,_jsx(_components.code,{children:`null`}),` for that field. The record is still ingested — a\nsingle bad timestamp does not reject the record or fail the page.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Consequence:`}),` a `,_jsx(_components.code,{children:`null`}),` `,_jsx(_components.code,{children:`updated_at`}),` means the record cannot participate in the\n`,_jsx(_components.a,{href:`/concepts/how-sync-works#ordering-and-the-watermark`,children:`watermark`}),` — an incremental sync may\nnot pick it up correctly. Keep `,_jsx(_components.code,{children:`updated_at`}),` valid and always advancing on every change.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`managers-are-not-linked-to-hunterai-logins`,children:`Managers are not linked to HunterAI logins`}),`\n`,_jsxs(_components.p,{children:[`CRM managers are ingested and used for attribution, but for a custom source they are `,_jsx(_components.strong,{children:`not`}),`\nautomatically turned into HunterAI logins. Per-manager dashboards, scoping, and coaching are\nunavailable until invitation-based linking ships. This is a deliberate security decision —\nsee `,_jsx(_components.a,{href:`/guides/connecting#what-does-not-work-yet`,children:`Go live → What does not work yet`}),`.`]})]})}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":"Limitations","description":"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.","href":"/limitations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Currency is not stored","slug":"currency-is-not-stored","depth":2,"children":[]},{"title":"Only the first contact on a lead is kept","slug":"only-the-first-contact-on-a-lead-is-kept","depth":2,"children":[]},{"title":"Tombstones apply to leads only","slug":"tombstones-apply-to-leads-only","depth":2,"children":[]},{"title":"Stage kind must be exactly open, won, or lost","slug":"stage-kind-must-be-exactly-open-won-or-lost","depth":2,"children":[]},{"title":"Won/lost depends on the stage being synced","slug":"won/lost-depends-on-the-stage-being-synced","depth":2,"children":[]},{"title":"Fields dropped entirely","slug":"fields-dropped-entirely","depth":2,"children":[]},{"title":"Field truncation limits","slug":"field-truncation-limits","depth":2,"children":[]},{"title":"Timestamp handling","slug":"timestamp-handling","depth":2,"children":[]},{"title":"Managers are not linked to HunterAI logins","slug":"managers-are-not-linked-to-hunterai-logins","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"hunter-67864d54","siteName":"HunterAI Integration","title":"Limitations - HunterAI Integration","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-28T13:23:04.084Z","originalFileLocation":"limitations.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=\"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.\">\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=\"Limitations - HunterAI Integration\">\u003cmeta data-mint-head property=\"og:description\" content=\"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HunterAI Integration\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://integration.hunterai.uz/limitations\">\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=Operations\u0026amp;title=Limitations\u0026amp;description=Real+constraints+of+the+v1.0+adapter.+Read+this+before+you+build+%E2%80%94+some+affect+how+you+model+currency%2C+contacts%2C+and+deletes.\u0026amp;theme=da11d5d870f3e521c5dc043c\u0026amp;signature=e535584cf7ed6c07a97d35c3e456f1a40cc672049fcae47a63b42cc1286fa09e\">\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=\"Limitations - HunterAI Integration\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hunter-67864d54.mintlify.site/_mintlify/api/og/v2?division=Operations\u0026amp;title=Limitations\u0026amp;description=Real+constraints+of+the+v1.0+adapter.+Read+this+before+you+build+%E2%80%94+some+affect+how+you+model+currency%2C+contacts%2C+and+deletes.\u0026amp;theme=da11d5d870f3e521c5dc043c\u0026amp;signature=e535584cf7ed6c07a97d35c3e456f1a40cc672049fcae47a63b42cc1286fa09e\">\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/limitations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/limitations.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/limitations#webpage\",\"url\":\"https://integration.hunterai.uz/limitations\",\"name\":\"Limitations\",\"description\":\"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.\",\"dateModified\":\"2026-07-28T13:23:04.084Z\",\"isPartOf\":{\"@id\":\"https://integration.hunterai.uz#website\"},\"breadcrumb\":{\"@id\":\"https://integration.hunterai.uz/limitations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://integration.hunterai.uz/limitations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Operations\",\"item\":\"https://integration.hunterai.uz/errors\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Limitations\",\"item\":\"https://integration.hunterai.uz/limitations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://integration.hunterai.uz/limitations#article\",\"headline\":\"Limitations\",\"name\":\"Limitations\",\"description\":\"Real constraints of the v1.0 adapter. Read this before you build — some affect how you model currency, contacts, and deletes.\",\"url\":\"https://integration.hunterai.uz/limitations\",\"mainEntityOfPage\":{\"@id\":\"https://integration.hunterai.uz/limitations#webpage\"},\"dateModified\":\"2026-07-28T13:23:04.084Z\",\"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":"/limitations.md","siteName":"HunterAI Integration","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Endpoint reference","pages":[{"title":"Endpoint reference","href":"/endpoints/pipelines"}]},{"tab":"Limits \u0026 policies","groups":[{"group":"Operations","pages":[{"title":"Errors","href":"/errors"},{"title":"Rate limits","description":"Declare a request rate and HunterAI throttles itself to it. It also backs off on 429.","href":"/rate-limits"},{"title":"Limitations","href":"/limitations"}]},{"group":"Release notes","pages":[{"title":"Changelog","description":"Version history of the HunterAI CRM integration spec.","href":"/changelog"}]}]}]},"basePath":"","title":"Limitations - HunterAI Integration","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}