{"id":28806,"date":"2026-02-19T16:35:53","date_gmt":"2026-02-19T14:35:53","guid":{"rendered":"https:\/\/aivie.ch\/faq\/come-posso-creare-un-contatto-in-aivie-tramite-api\/"},"modified":"2026-02-19T16:38:37","modified_gmt":"2026-02-19T14:38:37","slug":"come-posso-creare-un-contatto-in-aivie-tramite-api","status":"publish","type":"faq","link":"https:\/\/aivie.ch\/it\/faq\/come-posso-creare-un-contatto-in-aivie-tramite-api\/","title":{"rendered":"Come posso creare un contatto in Aivie tramite API?"},"content":{"rendered":"\n<p>In breve: puoi creare un contatto in Aivie facilmente tramite REST API inviando una richiesta POST all&#8217;endpoint <code>\/api\/contacts\/new<\/code> e autenticandoti tramite Basic Auth o OAuth2.<\/p>\n\n<!--more-->\n\n<h2 class=\"wp-block-heading\">Creare un contatto tramite API<\/h2>\n\n<p>Per creare un nuovo contatto, utilizza l&#8217;endpoint API:<\/p>\n\n<pre class=\"wp-block-code\"><code>POST \/api\/contacts\/new\n<\/code><\/pre>\n\n<p>Un semplice esempio con <code>curl<\/code> \u00e8 il seguente:<\/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>Importante:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>La richiesta deve essere inviata come <code>POST<\/code>.<\/li>\n\n\n\n<li>L&#8217;autenticazione avviene tramite <strong>Basic Auth<\/strong> o tramite <strong>OAuth2<\/strong>.<\/li>\n\n\n\n<li>L&#8217;header <code>Content-Type: application\/json<\/code> dovrebbe essere impostato.<\/li>\n\n\n\n<li>\u00c8 richiesto almeno il campo <code>email<\/code>.<\/li>\n<\/ul>\n\n<h2 class=\"wp-block-heading\">Autenticazione<\/h2>\n\n<p>Per l&#8217;accesso all&#8217;API sono disponibili due varianti:<\/p>\n\n<p><strong>Basic Auth<\/strong><br\/>Adatto per integrazioni semplici o sistemi interni. Qui vengono inviati un nome utente e una password codificati in Base64 nell&#8217;header Authorization. <\/p>\n\n<p><strong>OAuth2<\/strong><br\/>Consigliato per integrazioni in produzione con sistemi esterni. OAuth2 offre un&#8217;autenticazione pi\u00f9 sicura e flessibile. <\/p>\n\n<h2 class=\"wp-block-heading\">Passare ulteriori campi<\/h2>\n\n<p>Oltre a <code>email<\/code> e <code>firstname<\/code>, puoi inviare anche altri campi come ad esempio:<\/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>campi contatto personalizzati<\/li>\n<\/ul>\n\n<p>inviare insieme. I nomi dei campi devono corrispondere esattamente all\u2019alias del campo personalizzato. <\/p>\n\n<h2 class=\"wp-block-heading\">Documentazione ufficiale<\/h2>\n\n<p>Tutti i campi disponibili, i codici di risposta e ulteriori esempi li trovi nella documentazione API ufficiale:<\/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>L\u00ec sono descritti anche esempi per SDK e casi d&#8217;uso pi\u00f9 complessi.<\/p>\n\n<h2 class=\"wp-block-heading\">Riepilogo<\/h2>\n\n<p>Un contatto viene creato tramite una richiesta POST a <code>\/api\/contacts\/new<\/code>. L&#8217;autenticazione avviene tramite Basic Auth o OAuth2 e deve essere fornito almeno un indirizzo e-mail. Trovi la panoramica completa dei campi nella documentazione ufficiale delle API.  <\/p>\n","protected":false},"excerpt":{"rendered":"<p>In breve: puoi creare un contatto in Aivie facilmente tramite REST API inviando una richiesta POST all&#8217;endpoint \/api\/contacts\/new e autenticandoti tramite Basic Auth o OAuth2.<\/p>\n","protected":false},"featured_media":0,"template":"","categories":[],"tags":[1579,1580],"FaqCategories":[1004],"FaqTags":[1578,928],"class_list":["post-28806","faq","type-faq","status-publish","hentry","tag-api","tag-contatti","FaqCategories-integrazioni","FaqTags-api","FaqTags-contattateci"],"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>In breve: puoi creare un contatto in Aivie facilmente tramite REST API inviando una richiesta POST all&#8217;endpoint \/api\/contacts\/new e autenticandoti tramite Basic Auth o OAuth2. Creare un contatto tramite API Per creare un nuovo contatto, utilizza l&#8217;endpoint API: POST \/api\/contacts\/new Un semplice esempio con curl \u00e8 il seguente: curl \u2013location &#8216;https:\/\/aivie-v6.0.ddev.site\/api\/contacts\/new&#8217; \\ \u2013header &#8216;Authorization: Basic VVNF***==&#8217; \\ \u2013header &#8216;Content-Type: application\/json&#8217; \\ \u2013data-raw &#8216;{ \u201cemail\u201d: \u201caivie@dev.ch\u201d, \u201cfirstname\u201d: \u201caivie\u201d }&#8217; Importante: La richiesta deve essere inviata come POST. L&#8217;autenticazione avviene tramite Basic Auth o tramite OAuth2. L&#8217;header Content-Type: application\/json dovrebbe essere impostato. \u00c8 richiesto almeno il campo email. Autenticazione Per l&#8217;accesso all&#8217;API\u2026<\/p>\n","category_list_v2":"Senza categoria","author_info_v2":{"name":"","url":""},"comments_num_v2":"0 commento","_links":{"self":[{"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/faq\/28806","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/faq"}],"about":[{"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/types\/faq"}],"version-history":[{"count":4,"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/faq\/28806\/revisions"}],"predecessor-version":[{"id":28825,"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/faq\/28806\/revisions\/28825"}],"wp:attachment":[{"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/media?parent=28806"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/categories?post=28806"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/tags?post=28806"},{"taxonomy":"FaqCategories","embeddable":true,"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/FaqCategories?post=28806"},{"taxonomy":"FaqTags","embeddable":true,"href":"https:\/\/aivie.ch\/it\/wp-json\/wp\/v2\/FaqTags?post=28806"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}