# Qonvera ## API Docs - Root > Contacts [List contacts](https://api.qonvera.com/list-contacts-42148863e0.md): Returns contacts from the workspace bound to the API key, newest updated first. - Root > Contacts [Create a contact](https://api.qonvera.com/create-a-contact-42148864e0.md): At least one of name, email, or phone_e164 must be supplied. When omitted, lead_source defaults to public_api. - Root > Contacts [Get a contact](https://api.qonvera.com/get-a-contact-42148865e0.md): - Root > Contacts [Update safe contact fields](https://api.qonvera.com/update-safe-contact-fields-42148866e0.md): Requires expected_version. CRM lifecycle, current owner membership, field types, tenant references and current integration authority are checked in the write transaction. Mutation, durable response receipt and emitted changes commit atomically. Retry transport/503 failures with exactly the same key and body. The same key with another body conflicts. Deterministic rejected responses replay unchanged. Legacy incomplete receipts return LEGACY_REQUEST_REVIEW_REQUIRED and must be reconciled; do not bypass with a new key. - Root > Contacts [Create or update a prospect contact](https://api.qonvera.com/create-or-update-a-prospect-contact-44633430e0.md): Provider and external ID bind one workspace record. New matching phone/email candidates require review; bind a target_id with expected_version under a new request key. Default preserve_local protects teammate corrections; external permits only newer source timestamps; qonvera ignores incoming fields. Retired identities cannot be recreated. Identity ownership is pinned to the credential and requires support-assisted transfer after key rotation. Imports do not create conversations, opportunities or marketing consent. Customer enquiries use the separate intake workflow. All retries use the same key and body. - Root > Contacts [Read durable workspace changes](https://api.qonvera.com/read-durable-workspace-changes-44633431e0.md): Accepts any read scope; each returned resource is filtered by its own read scope. Decimal string cursors are commit-ordered per workspace. Keep until fixed while paging; persist next_cursor only after applying the page. Then omit until on the next poll. Versions and origin_credential_id help consumers prevent loops; equality/no-op checks remain required. Removed includes archive, merge and physical deletion, with ID-only data. Events before installation are not backfilled: obtain until, perform a complete paged scan, then consume changes after until. Scope expansion requires a new scan. This is a sync primitive, not a managed two-way provider connector. - Root > Accounts [List accounts](https://api.qonvera.com/list-accounts-42148867e0.md): Stable ascending-ID cursor pagination. Active contacts exclude archived/merged records. Obtain a changes-feed watermark before the initial scan, then replay changes after that watermark to cover concurrent edits and deletions. - Root > Accounts [Create an account](https://api.qonvera.com/create-an-account-42148868e0.md): Mutation, durable response receipt and emitted changes commit atomically. Retry transport/503 failures with exactly the same key and body. The same key with another body conflicts. Deterministic rejected responses replay unchanged. Legacy incomplete receipts return LEGACY_REQUEST_REVIEW_REQUIRED and must be reconciled; do not bypass with a new key. - Root > Accounts [Get an account](https://api.qonvera.com/get-an-account-42148869e0.md): Returns an active account. Archived accounts return 404. - Root > Accounts [Update safe account fields](https://api.qonvera.com/update-safe-account-fields-42148870e0.md): Requires expected_version. CRM lifecycle, current owner membership, field types, tenant references and current integration authority are checked in the write transaction. Mutation, durable response receipt and emitted changes commit atomically. Retry transport/503 failures with exactly the same key and body. The same key with another body conflicts. Deterministic rejected responses replay unchanged. Legacy incomplete receipts return LEGACY_REQUEST_REVIEW_REQUIRED and must be reconciled; do not bypass with a new key. - Root > Accounts [Create or update a prospect account](https://api.qonvera.com/create-or-update-a-prospect-account-44633432e0.md): Provider and external ID bind one workspace record. New matching phone/email candidates require review; bind a target_id with expected_version under a new request key. Default preserve_local protects teammate corrections; external permits only newer source timestamps; qonvera ignores incoming fields. Retired identities cannot be recreated. Identity ownership is pinned to the credential and requires support-assisted transfer after key rotation. Imports do not create conversations, opportunities or marketing consent. Customer enquiries use the separate intake workflow. All retries use the same key and body. - Root > Opportunities [List opportunities](https://api.qonvera.com/list-opportunities-42148871e0.md): Stable ascending-ID cursor pagination. Active contacts exclude archived/merged records. Obtain a changes-feed watermark before the initial scan, then replay changes after that watermark to cover concurrent edits and deletions. - Root > Opportunities [Atomically create an opportunity](https://api.qonvera.com/atomically-create-an-opportunity-42148872e0.md): Creates the opportunity, immutable service snapshots, initial stage history, owner, and required next action in one transaction. Supplied IDs must belong to the API key's workspace. - Root > Opportunities [Get an opportunity](https://api.qonvera.com/get-an-opportunity-42148873e0.md): - Root > Opportunities [Update safe opportunity fields](https://api.qonvera.com/update-safe-opportunity-fields-42148874e0.md): Does not expose stage or lifecycle status changes, which require Qonvera's audited lifecycle commands. - Root > Follow-ups [List follow-ups](https://api.qonvera.com/list-follow-ups-42148875e0.md): Stable ascending-ID cursor pagination. Active contacts exclude archived/merged records. Obtain a changes-feed watermark before the initial scan, then replay changes after that watermark to cover concurrent edits and deletions. - Root > Follow-ups [Create an open follow-up](https://api.qonvera.com/create-an-open-follow-up-42148876e0.md): Mutation, durable response receipt and emitted changes commit atomically. Retry transport/503 failures with exactly the same key and body. The same key with another body conflicts. Deterministic rejected responses replay unchanged. Legacy incomplete receipts return LEGACY_REQUEST_REVIEW_REQUIRED and must be reconciled; do not bypass with a new key. - Root > Follow-ups [Get a follow-up](https://api.qonvera.com/get-a-follow-up-42148877e0.md): - Root > Follow-ups [Update safe follow-up fields](https://api.qonvera.com/update-safe-follow-up-fields-42148878e0.md): Does not expose completion or cancellation because those transitions use audited Qonvera lifecycle commands. - Root > Catalogue [List services](https://api.qonvera.com/list-services-42148879e0.md): Stable ascending-ID cursor pagination. Active contacts exclude archived/merged records. Obtain a changes-feed watermark before the initial scan, then replay changes after that watermark to cover concurrent edits and deletions. - Root > Catalogue [List pipelines](https://api.qonvera.com/list-pipelines-42148880e0.md): Stable ascending-ID cursor pagination. Active contacts exclude archived/merged records. Obtain a changes-feed watermark before the initial scan, then replay changes after that watermark to cover concurrent edits and deletions. - Root [Receive a Qonvera CRM event](https://api.qonvera.com/receive-a-qonvera-crm-event-42148862e0.md): Verify X-Qonvera-Signature against the exact request bytes using HMAC-SHA256(secret, timestamp + '.' + rawBody), reject stale timestamps, and deduplicate X-Qonvera-Event-Id. Any 2xx acknowledges the event. Qonvera retries timeouts, 408, 409, 425, 429, and 5xx responses with bounded backoff. ## Schemas - Root [Uuid](https://api.qonvera.com/uuid-17190243d0.md): - Root [NullableUuid](https://api.qonvera.com/nullableuuid-17190244d0.md): - Root [NullableString](https://api.qonvera.com/nullablestring-17190245d0.md): - Root [NullableEmail](https://api.qonvera.com/nullableemail-17190246d0.md): - Root [NullableDate](https://api.qonvera.com/nullabledate-17190247d0.md): - Root [NullableDateTime](https://api.qonvera.com/nullabledatetime-17190248d0.md): - Root [Currency](https://api.qonvera.com/currency-17190249d0.md): - Root [TimestampFields](https://api.qonvera.com/timestampfields-17190250d0.md): - Root [Contact](https://api.qonvera.com/contact-17190251d0.md): - Root [ContactPatch](https://api.qonvera.com/contactpatch-17190252d0.md): - Root [ContactCreate](https://api.qonvera.com/contactcreate-17190253d0.md): - Root [Account](https://api.qonvera.com/account-17190254d0.md): - Root [AccountPatch](https://api.qonvera.com/accountpatch-17190255d0.md): - Root [AccountCreate](https://api.qonvera.com/accountcreate-17190256d0.md): - Root [ForecastCategory](https://api.qonvera.com/forecastcategory-17190257d0.md): - Root [Opportunity](https://api.qonvera.com/opportunity-17190258d0.md): - Root [OpportunityPatch](https://api.qonvera.com/opportunitypatch-17190259d0.md): - Root [OpportunityServiceItem](https://api.qonvera.com/opportunityserviceitem-17190260d0.md): - Root [OpportunityCreate](https://api.qonvera.com/opportunitycreate-17190261d0.md): - Root [OpportunityCreateResultData](https://api.qonvera.com/opportunitycreateresultdata-17190262d0.md): - Root [FollowupStatus](https://api.qonvera.com/followupstatus-17190263d0.md): - Root [Followup](https://api.qonvera.com/followup-17190264d0.md): - Root [FollowupPatch](https://api.qonvera.com/followuppatch-17190265d0.md): - Root [FollowupCreate](https://api.qonvera.com/followupcreate-17190266d0.md): - Root [Service](https://api.qonvera.com/service-17190267d0.md): - Root [Pipeline](https://api.qonvera.com/pipeline-17190268d0.md): - Root [ErrorDetail](https://api.qonvera.com/errordetail-17190269d0.md): - Root [ErrorEnvelope](https://api.qonvera.com/errorenvelope-17190270d0.md): - Root [ContactEnvelope](https://api.qonvera.com/contactenvelope-17190271d0.md): - Root [AccountEnvelope](https://api.qonvera.com/accountenvelope-17190272d0.md): - Root [OpportunityEnvelope](https://api.qonvera.com/opportunityenvelope-17190273d0.md): - Root [OpportunityCreateEnvelope](https://api.qonvera.com/opportunitycreateenvelope-17190274d0.md): - Root [FollowupEnvelope](https://api.qonvera.com/followupenvelope-17190275d0.md): - Root [ContactListEnvelope](https://api.qonvera.com/contactlistenvelope-17190276d0.md): - Root [AccountListEnvelope](https://api.qonvera.com/accountlistenvelope-17190277d0.md): - Root [OpportunityListEnvelope](https://api.qonvera.com/opportunitylistenvelope-17190278d0.md): - Root [FollowupListEnvelope](https://api.qonvera.com/followuplistenvelope-17190279d0.md): - Root [ServiceListEnvelope](https://api.qonvera.com/servicelistenvelope-17190280d0.md): - Root [PipelineListEnvelope](https://api.qonvera.com/pipelinelistenvelope-17190281d0.md): - Root [WebhookEventType](https://api.qonvera.com/webhookeventtype-17190282d0.md): - Root [WebhookEvent](https://api.qonvera.com/webhookevent-17190283d0.md): - Root [ContactWebhookData](https://api.qonvera.com/contactwebhookdata-17190284d0.md): - Root [AccountWebhookData](https://api.qonvera.com/accountwebhookdata-17190285d0.md): - Root [OpportunityWebhookData](https://api.qonvera.com/opportunitywebhookdata-17190286d0.md): - Root [FollowupWebhookData](https://api.qonvera.com/followupwebhookdata-17190287d0.md): - Root [TestWebhookData](https://api.qonvera.com/testwebhookdata-17190288d0.md): - Root [ProspectImport](https://api.qonvera.com/prospectimport-18044991d0.md): - Root [ImportResult](https://api.qonvera.com/importresult-18044992d0.md): - Root [ChangePage](https://api.qonvera.com/changepage-18044993d0.md):