{"id":28815,"date":"2026-02-19T16:37:07","date_gmt":"2026-02-19T14:37:07","guid":{"rendered":"https:\/\/aivie.ch\/faq\/comment-puis-je-creer-un-contact-via-lapi-dans-aivie\/"},"modified":"2026-02-19T16:38:37","modified_gmt":"2026-02-19T14:38:37","slug":"comment-puis-je-creer-un-contact-via-lapi-dans-aivie","status":"publish","type":"faq","link":"https:\/\/aivie.ch\/fr\/faq\/comment-puis-je-creer-un-contact-via-lapi-dans-aivie\/","title":{"rendered":"Comment puis-je cr\u00e9er un contact via l&rsquo;API dans Aivie ?"},"content":{"rendered":"\n<p>En bref : vous pouvez cr\u00e9er un contact dans Aivie tr\u00e8s facilement via l&rsquo;API REST en envoyant une requ\u00eate POST au point de terminaison <code>\/api\/contacts\/new<\/code> et en vous authentifiant par Basic Auth ou OAuth2.<\/p>\n\n<!--more-->\n\n<h2 class=\"wp-block-heading\">Cr\u00e9er un contact via l&rsquo;API<\/h2>\n\n<p>Pour cr\u00e9er un nouveau contact, utilisez le point de terminaison API :<\/p>\n\n<pre class=\"wp-block-code\"><code>POST \/api\/contacts\/new\n<\/code><\/pre>\n\n<p>Un exemple simple avec <code>curl<\/code> ressemble \u00e0 ceci :<\/p>\n\n<pre class=\"wp-block-code\"><code>curl --location 'https:\/\/aivie-v6.0.ddev.site\/api\/contacts\/new' \\\n--header 'Authorization: Basic VVNF***==' \\\n--header 'Content-Type: application\/json' \\\n--data-raw '{\n    \"email\": \"aivie@dev.ch\",\n    \"firstname\": \"aivie\"\n}'\n<\/code><\/pre>\n\n<p>Important :<\/p>\n\n<ul class=\"wp-block-list\">\n<li>La requ\u00eate doit \u00eatre envoy\u00e9e en tant que <code>POST<\/code>.<\/li>\n\n\n\n<li>L&rsquo;authentification s&rsquo;effectue soit par <strong>Basic Auth<\/strong>, soit par <strong>OAuth2<\/strong>.<\/li>\n\n\n\n<li>L&rsquo;en-t\u00eate <code>Content-Type: application\/json<\/code> doit \u00eatre d\u00e9fini.<\/li>\n\n\n\n<li>Le champ <code>email<\/code> est au minimum requis.<\/li>\n<\/ul>\n\n<h2 class=\"wp-block-heading\">Authentification<\/h2>\n\n<p>Deux variantes sont disponibles pour acc\u00e9der \u00e0 l&rsquo;API :<\/p>\n\n<p><strong>Basic Auth<\/strong><br\/>Adapt\u00e9 aux int\u00e9grations simples ou aux syst\u00e8mes internes. Ici, un nom d&rsquo;utilisateur et un mot de passe encod\u00e9s en Base64 sont transmis dans l&rsquo;en-t\u00eate Authorization. <\/p>\n\n<p><strong>OAuth2<\/strong><br\/>Recommand\u00e9 pour les int\u00e9grations en production avec des syst\u00e8mes externes. OAuth2 offre une authentification plus s\u00fbre et flexible. <\/p>\n\n<h2 class=\"wp-block-heading\">Transmettre des champs suppl\u00e9mentaires<\/h2>\n\n<p>Outre <code>email<\/code> et <code>firstname<\/code>, vous pouvez \u00e9galement transmettre d&rsquo;autres champs tels que :<\/p>\n\n<ul class=\"wp-block-list\">\n<li>lastname<\/li>\n\n\n\n<li>company<\/li>\n\n\n\n<li>phone<\/li>\n\n\n\n<li>vos propres champs de contact personnalis\u00e9s<\/li>\n<\/ul>\n\n<p>inclure. Les noms des champs doivent correspondre exactement \u00e0 l\u2019alias du champ personnalis\u00e9. <\/p>\n\n<h2 class=\"wp-block-heading\">Documentation officielle<\/h2>\n\n<p>Tous les champs disponibles, les codes de r\u00e9ponse et d&rsquo;autres exemples se trouvent dans la documentation officielle de l&rsquo;API :<\/p>\n\n<p><a href=\"https:\/\/devdocs.mautic.org\/en\/5.x\/rest_api\/contacts.html#create-contact\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/devdocs.mautic.org\/en\/5.x\/rest_api\/contacts.html#create-contact<\/a><\/p>\n\n<p>Des exemples de SDK et de cas d&rsquo;utilisation plus complexes y sont \u00e9galement d\u00e9crits.<\/p>\n\n<h2 class=\"wp-block-heading\">R\u00e9sum\u00e9<\/h2>\n\n<p>Un contact est cr\u00e9\u00e9 via une requ\u00eate POST vers <code>\/api\/contacts\/new<\/code>. L\u2019authentification s\u2019effectue via Basic Auth ou OAuth2, et au moins une adresse e-mail doit \u00eatre transmise. Vous trouverez la liste compl\u00e8te des champs dans la documentation officielle de l\u2019API.  <\/p>\n","protected":false},"excerpt":{"rendered":"<p>En bref : vous pouvez cr\u00e9er un contact dans Aivie tr\u00e8s facilement via l&rsquo;API REST en envoyant une requ\u00eate POST au point de terminaison \/api\/contacts\/new et en vous authentifiant par Basic Auth ou OAuth2.<\/p>\n","protected":false},"featured_media":0,"template":"","categories":[],"tags":[1584,1585],"FaqCategories":[1006],"FaqTags":[1583,924],"class_list":["post-28815","faq","type-faq","status-publish","hentry","tag-api","tag-contact","FaqCategories-integrations-fr","FaqTags-api","FaqTags-contact-fr"],"acf":[],"featured_image_urls_v2":{"full":"","thumbnail":"","medium":"","medium_large":"","large":"","post-thumbnail":"","aiv_480w":"","woocommerce_thumbnail":"","woocommerce_single":"","woocommerce_gallery_thumbnail":""},"post_excerpt_stackable_v2":"<p>En bref : vous pouvez cr\u00e9er un contact dans Aivie tr\u00e8s facilement via l&rsquo;API REST en envoyant une requ\u00eate POST au point de terminaison \/api\/contacts\/new et en vous authentifiant par Basic Auth ou OAuth2. Cr\u00e9er un contact via l&rsquo;API Pour cr\u00e9er un nouveau contact, utilisez le point de terminaison API : POST \/api\/contacts\/new Un exemple simple avec curl ressemble \u00e0 ceci : curl \u2013location &lsquo;https:\/\/aivie-v6.0.ddev.site\/api\/contacts\/new&rsquo; \\ \u2013header &lsquo;Authorization: Basic VVNF***==&rsquo; \\ \u2013header &lsquo;Content-Type: application\/json&rsquo; \\ \u2013data-raw &lsquo;{ \u00ab\u00a0email\u00a0\u00bb: \u00ab\u00a0aivie@dev.ch\u00a0\u00bb, \u00ab\u00a0firstname\u00a0\u00bb: \u00ab\u00a0aivie\u00a0\u00bb }&rsquo; Important : La requ\u00eate doit \u00eatre envoy\u00e9e en tant que POST. L&rsquo;authentification s&rsquo;effectue soit par Basic Auth, soit\u2026<\/p>\n","category_list_v2":"Non class\u00e9","author_info_v2":{"name":"","url":""},"comments_num_v2":"0 commentaire","_links":{"self":[{"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/faq\/28815","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/faq"}],"about":[{"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/types\/faq"}],"version-history":[{"count":3,"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/faq\/28815\/revisions"}],"predecessor-version":[{"id":28826,"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/faq\/28815\/revisions\/28826"}],"wp:attachment":[{"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/media?parent=28815"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/categories?post=28815"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/tags?post=28815"},{"taxonomy":"FaqCategories","embeddable":true,"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/FaqCategories?post=28815"},{"taxonomy":"FaqTags","embeddable":true,"href":"https:\/\/aivie.ch\/fr\/wp-json\/wp\/v2\/FaqTags?post=28815"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}