Crée un contact seul dans une agence du périmètre du token.
⚠️ À éviter dans le cas général. Pour démarrer une affaire, créez le contact avec sa transaction via POST /external-integration/sale, …/acquisition ou …/rental (bloc contact) : ces routes appliquent la déduplication ET l’allocation. Ne créez jamais un contact via cette route puis une transaction séparément — vous contournez la déduplication / l’allocation et créez des doublons.
agencyId est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de email / phone est requis. Pour un particulier (isIndividual ≠ false), firstName ou lastName est requis ; pour une entreprise (isIndividual: false), commercialName ou corporateName. Si un contact existe déjà (même téléphone/email dans l’agence), il est réutilisé et retourné avec isNew: false.
Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.
La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.
Corps
application/json
Au moins un de email / phone est requis. Particulier : firstName ou lastName. Entreprise (isIndividual: false) : commercialName ou corporateName.
agencyId
string
requis
Agence cible. Doit appartenir au périmètre autorisé de la clé.
Pattern: ^[a-fA-F0-9]{24}$
Exemple:
"618a35a36d932054e195ca0a"
firstName
string
lastName
string
email
string<email>
phone
string
Téléphone au format international.
isEmailVerified
boolean
isPhoneVerified
boolean
isIndividual
boolean
défaut:true
true (défaut) = particulier ; false = entreprise.
commercialName
string
corporateName
string
consent
object
Consentement à la prospection que vous avez recueilli. Déclarez le parcours dont la personne a vu la mention (journey), ou énoncez chaque canal. Sans journey, un canal absent est enregistré comme non consenti sur un nouveau contact, et laissé tel quel sur un contact déjà connu (dédup) : seul un false explicite retire alors un consentement. Voir le guide Consentement à la prospection.
Show child attributes
Réponse
Contact créé (ou réutilisé si déjà existant, isNew: false).
success
boolean
contact
object
Contact. firstName / lastName si isIndividual: true ; commercialName / corporateName si entreprise (isIndividual: false).
Show child attributes
isNew
boolean
false si un contact existant a été réutilisé (déduplication).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Avest API","description":"Documentation de l'API d'intégration externe Avest","colors":{"primary":"#0D9488","light":"#2DD4BF","dark":"#0F766E"},"footer":{"socials":{"website":"https://avest.fr"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"fr","href":"introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"avest","hasAudioNarration":false,"actualSubdomain":"avest","customDomains":[],"gitSource":{"type":"github","owner":"avest-vap","repo":"avest-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae371367879ae8452f7e8ea"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aecda1cdf343a7ca61a6ddc","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"fr","tag":"Guides","count":35},{"language":"fr","tag":"Référence API","count":33},{"language":"fr","tag":"Endpoints","count":31},{"language":"fr","tag":"Transactions","count":15},{"language":"fr","tag":"Matches","count":9},{"language":"fr","tag":"Contacts","count":8},{"language":"fr","tag":"Match","count":6},{"language":"fr","tag":"Activités","count":4},{"language":"fr","tag":"Démarrage","count":4},{"language":"fr","tag":"Activities","count":4}]},"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/contacts/créer-un-contact-seul","slug":"/api-reference/contacts/créer-un-contact-seul","pageMetadata":{"title":"Créer un contact seul","description":"Crée un contact **seul** dans une agence du périmètre du token.\n\n⚠️ **À éviter dans le cas général.** Pour démarrer une affaire, créez le contact **avec sa transaction** via `POST /external-integration/sale`, `…/acquisition` ou `…/rental` (bloc `contact`) : ces routes appliquent la déduplication ET l'allocation. **Ne créez jamais un contact via cette route puis une transaction séparément** — vous contournez la déduplication / l'allocation et créez des doublons.\n\n`agencyId` est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de `email` / `phone` est requis. Pour un particulier (`isIndividual` ≠ `false`), `firstName` ou `lastName` est requis ; pour une entreprise (`isIndividual: false`), `commercialName` ou `corporateName`. Si un contact existe déjà (même téléphone/email dans l'agence), il est réutilisé et retourné avec `isNew: false`.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/contact","href":"/api-reference/contacts/créer-un-contact-seul","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Crée un contact \", _jsx(_components.strong, {\n children: \"seul\"\n }), \" dans une agence du périmètre du token.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"⚠️ \", _jsx(_components.strong, {\n children: \"À éviter dans le cas général.\"\n }), \" Pour démarrer une affaire, créez le contact \", _jsx(_components.strong, {\n children: \"avec sa transaction\"\n }), \" via \", _jsx(_components.code, {\n children: \"POST /external-integration/sale\"\n }), \", \", _jsx(_components.code, {\n children: \"…/acquisition\"\n }), \" ou \", _jsx(_components.code, {\n children: \"…/rental\"\n }), \" (bloc \", _jsx(_components.code, {\n children: \"contact\"\n }), \") : ces routes appliquent la déduplication ET l’allocation. \", _jsx(_components.strong, {\n children: \"Ne créez jamais un contact via cette route puis une transaction séparément\"\n }), \" — vous contournez la déduplication / l’allocation et créez des doublons.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"agencyId\"\n }), \" est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de \", _jsx(_components.code, {\n children: \"email\"\n }), \" / \", _jsx(_components.code, {\n children: \"phone\"\n }), \" est requis. Pour un particulier (\", _jsx(_components.code, {\n children: \"isIndividual\"\n }), \" ≠ \", _jsx(_components.code, {\n children: \"false\"\n }), \"), \", _jsx(_components.code, {\n children: \"firstName\"\n }), \" ou \", _jsx(_components.code, {\n children: \"lastName\"\n }), \" est requis ; pour une entreprise (\", _jsx(_components.code, {\n children: \"isIndividual: false\"\n }), \"), \", _jsx(_components.code, {\n children: \"commercialName\"\n }), \" ou \", _jsx(_components.code, {\n children: \"corporateName\"\n }), \". Si un contact existe déjà (même téléphone/email dans l’agence), il est réutilisé et retourné avec \", _jsx(_components.code, {\n children: \"isNew: false\"\n }), \".\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Créer un contact seul","description":"Crée un contact **seul** dans une agence du périmètre du token.\n\n⚠️ **À éviter dans le cas général.** Pour démarrer une affaire, créez le contact **avec sa transaction** via `POST /external-integration/sale`, `…/acquisition` ou `…/rental` (bloc `contact`) : ces routes appliquent la déduplication ET l'allocation. **Ne créez jamais un contact via cette route puis une transaction séparément** — vous contournez la déduplication / l'allocation et créez des doublons.\n\n`agencyId` est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de `email` / `phone` est requis. Pour un particulier (`isIndividual` ≠ `false`), `firstName` ou `lastName` est requis ; pour une entreprise (`isIndividual: false`), `commercialName` ou `corporateName`. Si un contact existe déjà (même téléphone/email dans l'agence), il est réutilisé et retourné avec `isNew: false`.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/contact","href":"/api-reference/contacts/créer-un-contact-seul","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Contacts"],"operationId":"createContact","summary":"Créer un contact seul","description":"Crée un contact **seul** dans une agence du périmètre du token.\n\n⚠️ **À éviter dans le cas général.** Pour démarrer une affaire, créez le contact **avec sa transaction** via `POST /external-integration/sale`, `…/acquisition` ou `…/rental` (bloc `contact`) : ces routes appliquent la déduplication ET l'allocation. **Ne créez jamais un contact via cette route puis une transaction séparément** — vous contournez la déduplication / l'allocation et créez des doublons.\n\n`agencyId` est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de `email` / `phone` est requis. Pour un particulier (`isIndividual` ≠ `false`), `firstName` ou `lastName` est requis ; pour une entreprise (`isIndividual: false`), `commercialName` ou `corporateName`. Si un contact existe déjà (même téléphone/email dans l'agence), il est réutilisé et retourné avec `isNew: false`.","requestBody":"60ed7b33-39cf-4074-8de5-78ee54e4eb65","responses":{"201":"2f636b1e-f7ac-4db2-84d4-1d3bcc268125","400":"05ea5ad4-815a-439f-8821-81df4ad61351","401":"58bd7cb6-0ffb-4651-862e-de0d7dec5734","403":"2c2c4f66-5d61-43b1-9b33-96efbad89d2d","429":"2a97dec8-9acd-49b3-8570-a005d27aa0d8"},"method":"post","type":"path","servers":["e15be152-2381-40d8-ad40-a5594816c16a"],"security":["4a97fb4f-cac0-4748-bb5e-5bf85887eb04"],"path":"/external-integration/contact","baseUrlOptions":["https://api.avest.fr/v1"],"title":"Créer un contact seul","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agencyId"],"description":"Au moins un de `email` / `phone` est requis. Particulier : `firstName` ou `lastName`. Entreprise (`isIndividual: false`) : `commercialName` ou `corporateName`.","properties":{"agencyId":{"type":"string","description":"Agence cible. Doit appartenir au périmètre autorisé de la clé.","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","isRequired":true,"uniqueKey":"agencyId","typeLabel":"string"},"firstName":{"type":"string","uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","uniqueKey":"lastName","typeLabel":"string"},"email":{"type":"string","format":"email","uniqueKey":"email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Téléphone au format international.","uniqueKey":"phone","typeLabel":"string"},"isEmailVerified":{"type":"boolean","uniqueKey":"isEmailVerified","typeLabel":"boolean"},"isPhoneVerified":{"type":"boolean","uniqueKey":"isPhoneVerified","typeLabel":"boolean"},"isIndividual":{"type":"boolean","default":true,"description":"`true` (défaut) = particulier ; `false` = entreprise.","uniqueKey":"isIndividual","typeLabel":"boolean"},"commercialName":{"type":"string","uniqueKey":"commercialName","typeLabel":"string"},"corporateName":{"type":"string","uniqueKey":"corporateName","typeLabel":"string"},"consent":{"type":"object","description":"Consentement à la prospection que vous avez recueilli. Déclarez le parcours dont la personne a vu la mention (`journey`), ou énoncez chaque canal. Sans `journey`, un canal absent est enregistré comme non consenti sur un nouveau contact, et laissé tel quel sur un contact déjà connu (dédup) : seul un `false` explicite retire alors un consentement. Voir le guide [Consentement à la prospection](/guides/consentement).","properties":{"email":{"type":"boolean","description":"Consentement à la prospection par courriel.","uniqueKey":"consent.email","typeLabel":"boolean"},"phone":{"type":"boolean","description":"Consentement à la prospection téléphonique.","uniqueKey":"consent.phone","typeLabel":"boolean"},"sms":{"type":"boolean","description":"Consentement à la prospection par SMS.","uniqueKey":"consent.sms","typeLabel":"boolean"},"date":{"type":"string","format":"date-time","description":"Date de recueil, ISO 8601. Obligatoire dès qu'un canal est consenti (`true`, ou annoncé par `journey`). Ne peut pas être dans le futur.","uniqueKey":"consent.date","typeLabel":"string\u003cdate-time>"},"wordingText":{"type":"string","minLength":1,"maxLength":5000,"description":"Texte exact de la mention affichée à la personne. Obligatoire si `phone` est consenti.","uniqueKey":"consent.wordingText","typeLabel":"string"},"wordingVersion":{"type":"string","minLength":1,"maxLength":64,"description":"Version de la mention, selon votre propre référence. Obligatoire si `phone` est consenti.","uniqueKey":"consent.wordingVersion","typeLabel":"string"},"locale":{"type":"string","minLength":2,"maxLength":10,"description":"Langue de la mention (ex. `fr`). Obligatoire si `phone` est consenti.","uniqueKey":"consent.locale","typeLabel":"string"},"details":{"type":"string","minLength":1,"maxLength":1000,"description":"Contexte du recueil, conservé dans le journal d'audit.","uniqueKey":"consent.details","typeLabel":"string"},"durationYears":{"type":"integer","minimum":1,"maximum":3,"description":"Durée du consentement courriel et SMS, en années, à la création comme à la mise à jour ; trois ans si elle est absente. Le réglage de durée de l'agence ne s'applique pas. Ne s'applique pas au téléphone (un an).","uniqueKey":"consent.durationYears","typeLabel":"integer"},"retentionDurationYears":{"type":"integer","minimum":1,"maximum":20,"description":"Durée de conservation, en années. Ne peut que raccourcir la durée réglée par l'agence (3 ans par défaut, 10 au plus) : au-delà, elle est ramenée à celle-ci, sans erreur.","uniqueKey":"consent.retentionDurationYears","typeLabel":"integer"},"journey":{"type":"string","enum":["sale","rental","acquisition"],"description":"Parcours déclaré : les trois parcours annoncent les trois canaux (`email`, `phone`, `sms`), donc `date` et la mention (`wordingText`, `wordingVersion`, `locale`) sont requis, sauf `phone: false`. Création uniquement.","uniqueKey":"consent.journey","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"agencyId":"66cc91d475c9fac35c86ed80","firstName":"Jean","lastName":"Dupont","email":"jean.dupont@email.com","phone":"+33612345678"},"examples":{"Example":{"title":"Example","value":{"agencyId":"66cc91d475c9fac35c86ed80","firstName":"Jean","lastName":"Dupont","email":"jean.dupont@email.com","phone":"+33612345678"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"2f636b1e-f7ac-4db2-84d4-1d3bcc268125":{"description":"Contact créé (ou réutilisé si déjà existant, `isNew: false`).","headers":{"RateLimit-Limit":{"description":"Nombre de requêtes autorisées dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true,"uniqueKey":"success","typeLabel":"boolean"},"contact":{"type":"object","description":"Contact. `firstName` / `lastName` si `isIndividual: true` ; `commercialName` / `corporateName` si entreprise (`isIndividual: false`).","properties":{"id":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"contact.id","typeLabel":"string"},"title":{"type":"string","enum":["mr","mme"],"uniqueKey":"contact.title","typeLabel":"enum\u003cstring>"},"firstName":{"type":"string","uniqueKey":"contact.firstName","typeLabel":"string"},"lastName":{"type":"string","uniqueKey":"contact.lastName","typeLabel":"string"},"commercialName":{"type":"string","uniqueKey":"contact.commercialName","typeLabel":"string"},"corporateName":{"type":"string","uniqueKey":"contact.corporateName","typeLabel":"string"},"isIndividual":{"type":"boolean","uniqueKey":"contact.isIndividual","typeLabel":"boolean"},"contactDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["email","phone"],"isRequired":true,"uniqueKey":"contact.contactDetails.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"data":{"type":"string","isRequired":true,"uniqueKey":"contact.contactDetails.items.[INDEX].data","typeLabel":"string"}},"required":["type","data"],"uniqueKey":"contact.contactDetails.items.[INDEX]","typeLabel":"object"},"uniqueKey":"contact.contactDetails","typeLabel":"object[]"}},"uniqueKey":"contact","typeLabel":"object"},"isNew":{"type":"boolean","description":"`false` si un contact existant a été réutilisé (déduplication).","uniqueKey":"isNew","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"contact":{"id":"618a35a36d932054e195ca0a","firstName":"Jean","lastName":"Dupont","contactDetails":[{"type":"phone","data":"+33612345678"},{"type":"email","data":"jean.dupont@email.com"}]},"isNew":true},"examples":{"Example":{"title":"Example","value":{"success":true,"contact":{"id":"618a35a36d932054e195ca0a","firstName":"Jean","lastName":"Dupont","contactDetails":[{"type":"phone","data":"+33612345678"},{"type":"email","data":"jean.dupont@email.com"}]},"isNew":true}}},"exampleType":"examples"}},"exampleType":"examples"},"05ea5ad4-815a-439f-8821-81df4ad61351":{"description":"Requête invalide. Le champ `message` précise la cause (paramètre manquant, invalide, mutuellement exclusif, clé de query inconnue, `LinkedAPI agencyGroup is required`, etc.).\n\nLes exemples ci-dessous sont **illustratifs et non exhaustifs** : les messages réellement renvoyés dépendent de la route. En particulier, le rejet des clés de query inconnues n'est appliqué que par `/contact`, `/contacts`, `/user`, `/users` et `/{transaction}/search`.\n\nLa plupart des messages de validation sont préfixés par le contexte qui les émet, sous la forme `\"\u003cContexte> : \u003cmessage>\"`. **Ne faites jamais de correspondance exacte sur `message`** : basez-vous sur le code HTTP et traitez `message` comme du texte destiné au diagnostic.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errorCode":{"type":"string","description":"Code stable, présent sur certaines erreurs seulement (par exemple `VISIT_DATE_REQUIRED`, `CONTACT_DELETED`). À préférer à `message` pour reconnaître une erreur.","uniqueKey":"errorCode","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unParametreRequis":{"title":"unParametreRequis","value":{"success":false,"message":"One of phone, email, or search is required"}},"exclusif":{"title":"exclusif","value":{"success":false,"message":"Provide exactly one of phone, email, or search"}},"queryInconnue":{"title":"queryInconnue","value":{"success":false,"message":"Unsupported query parameter: foo"}},"telephoneInvalide":{"title":"telephoneInvalide","value":{"success":false,"message":"Invalid phone number"}},"emailInvalide":{"title":"emailInvalide","value":{"success":false,"message":"Invalid email"}},"searchTropCourt":{"title":"searchTropCourt","value":{"success":false,"message":"search must be at least 3 characters"}},"pageHorsLimites":{"title":"pageHorsLimites","value":{"success":false,"message":"page must be \u003c= 100"}},"agencyGroupManquant":{"title":"agencyGroupManquant","value":{"success":false,"message":"LinkedAPI agencyGroup is required"}}},"exampleType":"examples"}},"exampleType":"examples"},"58bd7cb6-0ffb-4651-862e-de0d7dec5734":{"description":"Token invalide. Renvoyé quand le header `Authorization: Bearer` est présent mais que sa valeur n'est pas un token exploitable (malformé, signature invalide, valeur vide) — `message` vaut alors `Invalid bearer token`.\n\nUn token bien formé mais qui ne correspond plus à aucune clé (révoquée ou régénérée) donne aussi un `401`, avec le message `Not authorized to access this resource`.\n\nL'absence du header, une clé en lecture seule et une IP non autorisée renvoient un `403`, pas un `401`.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errorCode":{"type":"string","description":"Code stable, présent sur certaines erreurs seulement (par exemple `VISIT_DATE_REQUIRED`, `CONTACT_DELETED`). À préférer à `message` pour reconnaître une erreur.","uniqueKey":"errorCode","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"tokenInvalide":{"title":"tokenInvalide","value":{"success":false,"message":"Invalid bearer token"}},"cleInconnue":{"title":"cleInconnue","value":{"success":false,"message":"Not authorized to access this resource"}}},"exampleType":"examples"}},"exampleType":"examples"},"2c2c4f66-5d61-43b1-9b33-96efbad89d2d":{"description":"Accès refusé. Trois causes donnent **exactement la même réponse** (même code, même `message`) :\n\n1. le header `Authorization` est absent ;\n2. la clé est en **lecture seule** et la requête est un `POST` ou un `PATCH` (voir le guide Authentification) ;\n3. la clé est en mode **sécurisé** et l'IP d'appel, lue dans `X-Real-IP`, n'est pas celle autorisée.\n\nSur les routes d'écriture, un document lié hors du périmètre de la clé renvoie également ce `403`.\n\nUn `403` sur vos seules écritures alors que vos lectures passent = clé en lecture seule.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errorCode":{"type":"string","description":"Code stable, présent sur certaines erreurs seulement (par exemple `VISIT_DATE_REQUIRED`, `CONTACT_DELETED`). À préférer à `message` pour reconnaître une erreur.","uniqueKey":"errorCode","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Not authorized to access this resource"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Not authorized to access this resource"}}},"exampleType":"examples"}},"exampleType":"examples"},"2a97dec8-9acd-49b3-8570-a005d27aa0d8":{"description":"Limite de débit dépassée : limite de la route (par groupe d'agences et par chemin) ou limite globale (200 requêtes / 10 s par clé, `message` `Too many requests, please try again later`).","headers":{"Retry-After":{"description":"Secondes à attendre avant de réessayer (présent sur les réponses `429`).","schema":{"type":"integer"}},"RateLimit-Limit":{"description":"Nombre de requêtes autorisées dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","example":"Rate limit exceeded","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"retryAfter":{"type":"integer","description":"Secondes avant de pouvoir réessayer.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Rate limit exceeded","retryAfter":27},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Rate limit exceeded","retryAfter":27}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4a97fb4f-cac0-4748-bb5e-5bf85887eb04":{"linkedApiToken":{"type":"http","scheme":"bearer","description":"Token LinkedAPI avec scope `externalIntegration`. La clé doit avoir un `agencyGroup` configuré (sinon `400 LinkedAPI agencyGroup is required`). Fourni via l'en-tête `Authorization: Bearer {linkedAPI_token}`. Si la clé a `secure === true`, l'IP appelante doit être whitelistée (en-tête `X-Real-IP`), sinon `403 Not authorized to access this resource`.\n\nLa clé porte aussi un **niveau d'accès** : en lecture seule, elle n'autorise que les `GET` ; un `POST` ou un `PATCH` renvoie alors `403 Not authorized to access this resource`, soit la même réponse qu'une requête sans en-tête `Authorization`. Voir le guide Authentification.","scopes":[],"schemeName":"linkedApiToken"}}},"servers":{"e15be152-2381-40d8-ad40-a5594816c16a":{"url":"https://api.avest.fr/v1","description":"API de production Avest"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Token LinkedAPI avec scope `externalIntegration`. La clé doit avoir un `agencyGroup` configuré (sinon `400 LinkedAPI agencyGroup is required`). Fourni via l'en-tête `Authorization: Bearer {linkedAPI_token}`. Si la clé a `secure === true`, l'IP appelante doit être whitelistée (en-tête `X-Real-IP`), sinon `403 Not authorized to access this resource`.\n\nLa clé porte aussi un **niveau d'accès** : en lecture seule, elle n'autorise que les `GET` ; un `POST` ou un `PATCH` renvoie alors `403 Not authorized to access this resource`, soit la même réponse qu'une requête sans en-tête `Authorization`. Voir le guide Authentification.","scopes":[],"schemeName":"linkedApiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Token LinkedAPI avec scope `externalIntegration`. La clé doit avoir un `agencyGroup` configuré (sinon `400 LinkedAPI agencyGroup is required`). Fourni via l'en-tête `Authorization: Bearer {linkedAPI_token}`. Si la clé a `secure === true`, l'IP appelante doit être whitelistée (en-tête `X-Real-IP`), sinon `403 Not authorized to access this resource`.\n\nLa clé porte aussi un **niveau d'accès** : en lecture seule, elle n'autorise que les `GET` ; un `POST` ou un `PATCH` renvoie alors `403 Not authorized to access this resource`, soit la même réponse qu'une requête sans en-tête `Authorization`. Voir le guide Authentification.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"linkedApiToken","name":"Authorization"}],"title":"linkedApiToken"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"avest","siteName":"Avest API","title":"Créer un contact seul - Avest API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"fr":{"href":"/api-reference/contacts/créer-un-contact-seul","matchLevel":0}}},"lastModified":"2026-11-05T19:33:53.566Z","originalFileLocation":"api-reference/contacts/créer-un-contact-seul.mdx","locale":"fr"},"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=\"Crée un contact seul dans une agence du périmètre du token. ⚠️ À éviter dans le cas général. Pour démarrer une affaire, créez le contact avec sa transaction via POST /external-integration/sale, …/acquisition ou …/rental (bloc contact) : ces routes appliquent la déduplication ET l\u0026#x27;allocation. Ne créez jamais un contact via cette route puis une transaction séparément — vous contournez la déduplication / l\u0026#x27;allocation et créez des doublons. agencyId est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de email / phone est requis. Pour un particulier (isIndividual ≠ false), firstName ou lastName est requis ; pour une entreprise (isIndividual: false), commercialName ou corporateName. Si un contact existe déjà (même téléphone/email dans l\u0026#x27;agence), il est réutilisé et retourné avec isNew: false.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Avest API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Créer un contact seul - Avest API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Crée un contact seul dans une agence du périmètre du token. ⚠️ À éviter dans le cas général. Pour démarrer une affaire, créez le contact avec sa transaction via POST /external-integration/sale, …/acquisition ou …/rental (bloc contact) : ces routes appliquent la déduplication ET l\u0026#x27;allocation. Ne créez jamais un contact via cette route puis une transaction séparément — vous contournez la déduplication / l\u0026#x27;allocation et créez des doublons. agencyId est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de email / phone est requis. Pour un particulier (isIndividual ≠ false), firstName ou lastName est requis ; pour une entreprise (isIndividual: false), commercialName ou corporateName. Si un contact existe déjà (même téléphone/email dans l\u0026#x27;agence), il est réutilisé et retourné avec isNew: false.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Avest API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://avest.mintlify.app/api-reference/contacts/créer-un-contact-seul\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://avest.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Cr%C3%A9er+un+contact+seul\u0026amp;description=Cr%C3%A9e+un+contact+**seul**+dans+une+agence+du+p%C3%A9rim%C3%A8tre+du+token.%0A%0A%E2%9A%A0%EF%B8%8F+**%C3%80+%C3%A9viter+dans+le+cas+g%C3%A9n%C3%A9ral.**+Pour+d%C3%A9marrer+une+affaire%2C+cr%C3%A9ez+le+contact+**avec+sa+tran\u0026amp;theme=bb9c368e6952746f0f50bcde\u0026amp;signature=a6c6524324cb8a50290351ffc2c404d901986faf33428dd6d1fd9e50aaa257af\">\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=\"Créer un contact seul - Avest API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Crée un contact seul dans une agence du périmètre du token. ⚠️ À éviter dans le cas général. Pour démarrer une affaire, créez le contact avec sa transaction via POST /external-integration/sale, …/acquisition ou …/rental (bloc contact) : ces routes appliquent la déduplication ET l\u0026#x27;allocation. Ne créez jamais un contact via cette route puis une transaction séparément — vous contournez la déduplication / l\u0026#x27;allocation et créez des doublons. agencyId est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de email / phone est requis. Pour un particulier (isIndividual ≠ false), firstName ou lastName est requis ; pour une entreprise (isIndividual: false), commercialName ou corporateName. Si un contact existe déjà (même téléphone/email dans l\u0026#x27;agence), il est réutilisé et retourné avec isNew: false.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://avest.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Cr%C3%A9er+un+contact+seul\u0026amp;description=Cr%C3%A9e+un+contact+**seul**+dans+une+agence+du+p%C3%A9rim%C3%A8tre+du+token.%0A%0A%E2%9A%A0%EF%B8%8F+**%C3%80+%C3%A9viter+dans+le+cas+g%C3%A9n%C3%A9ral.**+Pour+d%C3%A9marrer+une+affaire%2C+cr%C3%A9ez+le+contact+**avec+sa+tran\u0026amp;theme=bb9c368e6952746f0f50bcde\u0026amp;signature=a6c6524324cb8a50290351ffc2c404d901986faf33428dd6d1fd9e50aaa257af\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Avest API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9488\">\u003clink data-mint-head rel=\"canonical\" href=\"https://avest.mintlify.app/api-reference/contacts/créer-un-contact-seul\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contacts/cr%C3%A9er-un-contact-seul.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://avest.mintlify.app/#organization\",\"name\":\"Avest API\",\"url\":\"https://avest.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://avest.mintlify.app#website\",\"name\":\"Avest API\",\"url\":\"https://avest.mintlify.app\",\"publisher\":{\"@id\":\"https://avest.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul#webpage\",\"url\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul\",\"name\":\"Créer un contact seul\",\"description\":\"Crée un contact seul dans une agence du périmètre du token. ⚠️ À éviter dans le cas général. Pour démarrer une affaire, créez le contact avec sa transaction via POST /external-integration/sale, …/acquisition ou …/rental (bloc contact) : ces routes appliquent la déduplication ET l'allocation. Ne créez jamais un contact via cette route puis une transaction séparément — vous contournez la déduplication / l'allocation et créez des doublons. agencyId est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de email / phone est requis. Pour un particulier (isIndividual ≠ false), firstName ou lastName est requis ; pour une entreprise (isIndividual: false), commercialName ou corporateName. Si un contact existe déjà (même téléphone/email dans l'agence), il est réutilisé et retourné avec isNew: false.\",\"dateModified\":\"2026-11-05T19:33:53.566Z\",\"isPartOf\":{\"@id\":\"https://avest.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contacts\",\"item\":\"https://avest.mintlify.app/api-reference/contacts/r%C3%A9cup%C3%A9rer-un-contact-et-ses-transactions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Créer un contact seul\",\"item\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul#apireference\",\"headline\":\"Créer un contact seul\",\"name\":\"Créer un contact seul\",\"description\":\"Crée un contact seul dans une agence du périmètre du token. ⚠️ À éviter dans le cas général. Pour démarrer une affaire, créez le contact avec sa transaction via POST /external-integration/sale, …/acquisition ou …/rental (bloc contact) : ces routes appliquent la déduplication ET l'allocation. Ne créez jamais un contact via cette route puis une transaction séparément — vous contournez la déduplication / l'allocation et créez des doublons. agencyId est obligatoire et doit appartenir au périmètre autorisé de la clé. Au moins un de email / phone est requis. Pour un particulier (isIndividual ≠ false), firstName ou lastName est requis ; pour une entreprise (isIndividual: false), commercialName ou corporateName. Si un contact existe déjà (même téléphone/email dans l'agence), il est réutilisé et retourné avec isNew: false.\",\"url\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul\",\"mainEntityOfPage\":{\"@id\":\"https://avest.mintlify.app/api-reference/contacts/cr%C3%A9er-un-contact-seul#webpage\"},\"dateModified\":\"2026-11-05T19:33:53.566Z\",\"publisher\":{\"@id\":\"https://avest.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://avest.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Avest API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Avest API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/contacts/cr%C3%A9er-un-contact-seul.md","siteName":"Avest API","nav":{"global":null,"languages":[{"language":"fr","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Référence API","groups":[{"group":"Contacts","pages":[{"title":"Récupérer un contact et ses transactions","description":"Recherche un contact par téléphone, email, ou texte libre, et retourne ses transactions associées (ventes, acquisitions, locations).\n\nExactement **un** des trois paramètres `phone`, `email`, `search` doit être fourni — ils sont mutuellement exclusifs. Zéro ou plus d'un → `400`. Toute clé de query non listée → `400`.\n\nEn mode `phone` / `email`, le match est exact (email normalisé en minuscules) ; retourne `null` si aucun contact ne correspond. En mode `search`, seul le meilleur résultat est retourné. Les résultats sont limités au périmètre autorisé du token. Endpoint en lecture seule.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/contact","href":"/api-reference/contacts/récupérer-un-contact-et-ses-transactions"},{"title":"Créer un contact seul","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/contact","href":"/api-reference/contacts/créer-un-contact-seul"},{"title":"Lister des contacts (paginé)","description":"Liste paginée de contacts par téléphone, email, ou texte libre. Ne retourne **pas** les transactions associées — uniquement les contacts. Pour un contact + ses transactions, utiliser `GET /external-integration/contact` (singulier).\n\nExactement **un** des trois paramètres `phone`, `email`, `search` doit être fourni (mutuellement exclusifs). Toute clé de query non listée → `400`.\n\nTaille de page fixe : 100 contacts. Pas de `total` retourné — itérer jusqu'à `hasMore: false`. `page` max : 100 (soit 10 000 contacts cumulés). Mode `phone` / `email` : tri par `createdAt` desc. Mode `search` : tri par pertinence. Endpoint en lecture seule.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/contacts","href":"/api-reference/contacts/lister-des-contacts-paginé"},{"title":"Mettre à jour un contact","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/contact/{contactId}","href":"/api-reference/contacts/mettre-à-jour-un-contact"}]},{"group":"Key","pages":[{"title":"Connaître le type de sa clé","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/key","href":"/api-reference/key/connaître-le-type-de-sa-clé"}]},{"group":"Agencies","pages":[{"title":"Lister les agences accessibles","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/agencies","href":"/api-reference/agencies/lister-les-agences-accessibles"}]},{"group":"Users","pages":[{"title":"Récupérer un collaborateur par identifiant","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/user","href":"/api-reference/users/récupérer-un-collaborateur-par-identifiant"},{"title":"Lister les collaborateurs (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/users","href":"/api-reference/users/lister-les-collaborateurs-paginé"}]},{"group":"Shift planning","pages":[{"title":"Relire le planning de permanence d'une semaine","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/agency/{agencyId}/shift-planning/{transaction}","href":"/api-reference/shift-planning/relire-le-planning-de-permanence-dune-semaine"},{"title":"Alimenter le planning de permanence d'une semaine","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/agency/{agencyId}/shift-planning/{transaction}","href":"/api-reference/shift-planning/alimenter-le-planning-de-permanence-dune-semaine"}]},{"group":"Transactions","pages":[{"title":"Rechercher des transactions (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/{transaction}/search","href":"/api-reference/transactions/rechercher-des-transactions-paginé"},{"title":"Récupérer une transaction par id ou customId","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/{transaction}","href":"/api-reference/transactions/récupérer-une-transaction-par-id-ou-customid"},{"title":"Mettre à jour les critères d'une acquisition","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/acquisition/{acquisitionId}","href":"/api-reference/transactions/mettre-à-jour-les-critères-dune-acquisition"},{"title":"Mettre à jour une vente ciblée par identifiant","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/sale/{saleId}","href":"/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant"},{"title":"Qualifier un prospect acquéreur","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/acquisition/{acquisitionId}/qualify","href":"/api-reference/transactions/qualifier-un-prospect-acquéreur"}]},{"group":"Lead generation","pages":[{"title":"Créer ou mettre à jour une vente","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/sale","href":"/api-reference/lead-generation/créer-ou-mettre-à-jour-une-vente"},{"title":"Créer ou mettre à jour une acquisition","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/acquisition","href":"/api-reference/lead-generation/créer-ou-mettre-à-jour-une-acquisition"},{"title":"Créer ou mettre à jour une location","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/rental","href":"/api-reference/lead-generation/créer-ou-mettre-à-jour-une-location"}]},{"group":"Matches","pages":[{"title":"Récupérer un rapprochement par id ou customId","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match","href":"/api-reference/matches/récupérer-un-rapprochement-par-id-ou-customid"},{"title":"Rechercher des rapprochements","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match/search","href":"/api-reference/matches/rechercher-des-rapprochements"},{"title":"Faire avancer l'étape d'une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/match/{matchId}","href":"/api-reference/matches/faire-avancer-létape-dune-mise-en-relation"},{"title":"Lister les visites d'une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match/{matchId}/visits","href":"/api-reference/matches/lister-les-visites-dune-mise-en-relation"},{"title":"Créer une visite sur une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/match/{matchId}/visit","href":"/api-reference/matches/créer-une-visite-sur-une-mise-en-relation"},{"title":"Modifier ou annuler une visite","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/match/{matchId}/visit/{activityId}","href":"/api-reference/matches/modifier-ou-annuler-une-visite"},{"title":"Lister les offres d'une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match/{matchId}/offers","href":"/api-reference/matches/lister-les-offres-dune-mise-en-relation"},{"title":"Créer une offre sur une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/match/{matchId}/offer","href":"/api-reference/matches/créer-une-offre-sur-une-mise-en-relation"},{"title":"Faire évoluer une offre","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/match/{matchId}/offer/{activityId}","href":"/api-reference/matches/faire-évoluer-une-offre"}]},{"group":"Activities","pages":[{"title":"Lister les activités d'un document (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/activities","href":"/api-reference/activities/lister-les-activités-dun-document-paginé"},{"title":"Créer une activité sur un document","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/activity","href":"/api-reference/activities/créer-une-activité-sur-un-document"},{"title":"Supprimer une note","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /external-integration/activity/{activityId}","href":"/api-reference/activities/supprimer-une-note"},{"title":"Clôturer, rouvrir une activité ou corriger une note","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/activity/{activityId}","href":"/api-reference/activities/clôturer-rouvrir-une-activité-ou-corriger-une-note"}]},{"group":"Ads","pages":[{"title":"Récupérer une annonce par id ou référence","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/ad","href":"/api-reference/ads/récupérer-une-annonce-par-id-ou-référence"},{"title":"Rechercher des annonces (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/ad/search","href":"/api-reference/ads/rechercher-des-annonces-paginé"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]}]},"basePath":"","title":"Créer un contact seul - Avest API","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}