> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update draft > Créez ou mettez à jour la version brouillon d'un e-mail marketing. S'il n'existe aucun brouillon, le système en crée un à partir de l'e-mail « publié » et applique le corps de la requête au brouillon. La version brouillon n'existe que dans la mémoire tampon — l'e-mail n'est pas cloné. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/marketing-marketing-emails-v2026-09.json PATCH /marketing/emails/2026-09/{emailId}/draft openapi: 3.0.1 info: title: E-mails marketing description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Vous pouvez créer des e-mails marketing par programme, puis récupérer leurs statistiques d'envoi ultérieurement. x-hubspot-introduction: >- Utilisez l'API d'e-mail marketing pour créer, gérer et récupérer des détails concernant les e-mails marketing. Vous pouvez également utiliser cette API pour récupérer des statistiques concernant les envois d'e-mails, similaires à ce que vous pouvez voir dans HubSpot. servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Emails paths: /marketing/emails/2026-09/{emailId}/draft: patch: tags: - Emails summary: Créer ou mettre à jour la version brouillon description: "Créez ou mettez à jour la version brouillon d'un e-mail marketing. S'il n'existe aucun brouillon, le système en crée un à partir de l'e-mail «\_publié\_» et applique le corps de la requête au brouillon. La version brouillon n'existe que dans la mémoire tampon — l'e-mail n'est pas cloné." operationId: patch-/marketing/emails/2026-09/{emailId}/draft_upsertDraft parameters: - name: emailId in: path description: L'identifiant unique du brouillon d'e-mail à mettre à jour. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/EmailUpdateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicEmail' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.email.read - oauth2: - marketing.email.write - oauth2: - content components: schemas: EmailUpdateRequest: type: object properties: activeDomain: type: string description: Le domaine actif de l'e-mail. archived: type: boolean description: Détermine si l'e-mail est archivé ou non. businessUnitId: type: integer description: L'ID de l'unité commerciale associée à l'e-mail. format: int64 campaign: type: string description: L'ID de la campagne à laquelle cet e-mail est associé. content: $ref: '#/components/schemas/PublicEmailContent' folderIdV2: type: integer description: L'identifiant du dossier dans lequel l'e-mail sera stocké. format: int64 from: $ref: '#/components/schemas/PublicEmailFromDetails' jitterSendTime: type: boolean description: >- Détermine si l'heure d'envoi des e-mails doit être aléatoire afin d'éviter que tous les e-mails soient envoyés exactement au même moment. language: type: string description: "Le code de la langue de l'e-mail, par exemple «\_en\_» pour l'anglais." enum: - aa - ab - ae - af - af-na - af-za - agq - agq-cm - ak - ak-gh - am - am-et - an - ann - ann-ng - ar - ar-001 - ar-ae - ar-bh - ar-dj - ar-dz - ar-eg - ar-eh - ar-er - ar-il - ar-iq - ar-jo - ar-km - ar-kw - ar-lb - ar-ly - ar-ma - ar-mr - ar-om - ar-ps - ar-qa - ar-sa - ar-sd - ar-so - ar-ss - ar-sy - ar-td - ar-tn - ar-ye - as - as-in - asa - asa-tz - ast - ast-es - av - ay - az - az-az - ba - bal - bal-pk - bas - bas-cm - be - be-by - bem - bem-zm - bez - bez-tz - bg - bg-bg - bgc - bgc-in - bho - bho-in - bi - blo - blo-bj - bm - bm-ml - bn - bn-bd - bn-in - bo - bo-cn - bo-in - br - br-fr - brx - brx-in - bs - bs-ba - ca - ca-ad - ca-es - ca-fr - ca-it - ccp - ccp-bd - ccp-in - ce - ce-ru - ceb - ceb-ph - cgg - cgg-ug - ch - chr - chr-us - ckb - ckb-iq - ckb-ir - co - cr - cs - cs-cz - csw - csw-ca - cu - cu-ru - cv - cv-ru - cy - cy-gb - da - da-dk - da-gl - dav - dav-ke - de - de-at - de-be - de-ch - de-de - de-gr - de-it - de-li - de-lu - dje - dje-ne - doi - doi-in - dsb - dsb-de - dua - dua-cm - dv - dyo - dyo-sn - dz - dz-bt - ebu - ebu-ke - ee - ee-gh - ee-tg - el - el-cy - el-gr - en - en-001 - en-150 - en-ae - en-ag - en-ai - en-as - en-at - en-au - en-bb - en-be - en-bi - en-bm - en-bs - en-bw - en-bz - en-ca - en-cc - en-ch - en-ck - en-cm - en-cn - en-cx - en-cy - en-cz - en-de - en-dg - en-dk - en-dm - en-ee - en-eg - en-er - en-es - en-fi - en-fj - en-fk - en-fm - en-fr - en-gb - en-gd - en-gg - en-gh - en-gi - en-gm - en-gs - en-gu - en-gy - en-hk - en-hu - en-id - en-ie - en-il - en-im - en-in - en-io - en-it - en-je - en-jm - en-ke - en-ki - en-kn - en-ky - en-lc - en-lr - en-ls - en-lu - en-mg - en-mh - en-mo - en-mp - en-ms - en-mt - en-mu - en-mv - en-mw - en-mx - en-my - en-na - en-nf - en-ng - en-nl - en-no - en-nr - en-nu - en-nz - en-pg - en-ph - en-pk - en-pl - en-pn - en-pr - en-pt - en-pw - en-ro - en-rw - en-sb - en-sc - en-sd - en-se - en-sg - en-sh - en-si - en-sk - en-sl - en-ss - en-sx - en-sz - en-tc - en-th - en-tk - en-tn - en-to - en-tt - en-tv - en-tz - en-ug - en-um - en-us - en-vc - en-vg - en-vi - en-vn - en-vu - en-ws - en-za - en-zm - en-zw - eo - eo-001 - es - es-419 - es-ar - es-bo - es-br - es-bz - es-cl - es-co - es-cr - es-cu - es-do - es-ea - es-ec - es-es - es-gq - es-gt - es-hn - es-ic - es-mx - es-ni - es-pa - es-pe - es-ph - es-pr - es-py - es-sv - es-us - es-uy - es-ve - et - et-ee - eu - eu-es - ewo - ewo-cm - fa - fa-af - fa-ir - ff - ff-bf - ff-cm - ff-gh - ff-gm - ff-gn - ff-gw - ff-lr - ff-mr - ff-ne - ff-ng - ff-sl - ff-sn - fi - fi-fi - fil - fil-ph - fj - fo - fo-dk - fo-fo - fr - fr-be - fr-bf - fr-bi - fr-bj - fr-bl - fr-ca - fr-cd - fr-cf - fr-cg - fr-ch - fr-ci - fr-cm - fr-dj - fr-dz - fr-fr - fr-ga - fr-gf - fr-gn - fr-gp - fr-gq - fr-ht - fr-km - fr-lu - fr-ma - fr-mc - fr-mf - fr-mg - fr-ml - fr-mq - fr-mr - fr-mu - fr-nc - fr-ne - fr-pf - fr-pm - fr-re - fr-rw - fr-sc - fr-sn - fr-sy - fr-td - fr-tg - fr-tn - fr-vu - fr-wf - fr-yt - frr - frr-de - fur - fur-it - fy - fy-nl - ga - ga-gb - ga-ie - gaa - gaa-gh - gd - gd-gb - gl - gl-es - gn - gsw - gsw-ch - gsw-fr - gsw-li - gu - gu-in - guz - guz-ke - gv - gv-im - ha - ha-gh - ha-ne - ha-ng - haw - haw-us - he - he-il - hi - hi-in - hmn - ho - hr - hr-ba - hr-hr - hsb - hsb-de - ht - ht-ht - hu - hu-hu - hy - hy-am - hz - ia - ia-001 - id - id-id - ie - ie-ee - ig - ig-ng - ii - ii-cn - ik - io - is - is-is - it - it-ch - it-it - it-sm - it-va - iu - ja - ja-jp - jgo - jgo-cm - jmc - jmc-tz - jv - jv-id - ka - ka-ge - kab - kab-dz - kam - kam-ke - kar - kde - kde-tz - kea - kea-cv - kg - kgp - kgp-br - kh - khq - khq-ml - ki - ki-ke - kj - kk - kk-kz - kkj - kkj-cm - kl - kl-gl - kln - kln-ke - km - km-kh - kn - kn-in - ko - ko-cn - ko-kp - ko-kr - kok - kok-in - kr - ks - ks-in - ksb - ksb-tz - ksf - ksf-cm - ksh - ksh-de - ku - ku-tr - kv - kw - kw-gb - kxv - kxv-in - ky - ky-kg - la - lag - lag-tz - lb - lb-lu - lg - lg-ug - li - lij - lij-it - lkt - lkt-us - lmo - lmo-it - ln - ln-ao - ln-cd - ln-cf - ln-cg - lo - lo-la - lrc - lrc-iq - lrc-ir - lt - lt-lt - lu - lu-cd - luo - luo-ke - luy - luy-ke - lv - lv-lv - mai - mai-in - mas - mas-ke - mas-tz - mdf - mdf-ru - mer - mer-ke - mfe - mfe-mu - mg - mg-mg - mgh - mgh-mz - mgo - mgo-cm - mh - mi - mi-nz - mk - mk-mk - ml - ml-in - mn - mn-mn - mni - mni-in - mr - mr-in - ms - ms-bn - ms-id - ms-my - ms-sg - mt - mt-mt - mua - mua-cm - my - my-mm - mzn - mzn-ir - na - naq - naq-na - nb - nb-no - nb-sj - nd - nd-zw - nds - nds-de - nds-nl - ne - ne-in - ne-np - ng - nl - nl-aw - nl-be - nl-bq - nl-ch - nl-cw - nl-lu - nl-nl - nl-sr - nl-sx - nmg - nmg-cm - nn - nn-no - nnh - nnh-cm - 'no' - no-no - nqo - nqo-gn - nr - nso - nso-za - nus - nus-ss - nv - ny - nyn - nyn-ug - oc - oc-es - oc-fr - oj - om - om-et - om-ke - or - or-in - os - os-ge - os-ru - pa - pa-in - pa-pk - pcm - pcm-ng - pi - pis - pis-sb - pl - pl-pl - prg - prg-001 - ps - ps-af - ps-pk - pt - pt-ao - pt-br - pt-ch - pt-cv - pt-gq - pt-gw - pt-lu - pt-mo - pt-mz - pt-pt - pt-st - pt-tl - qu - qu-bo - qu-ec - qu-pe - raj - raj-in - rm - rm-ch - rn - rn-bi - ro - ro-md - ro-ro - rof - rof-tz - ru - ru-by - ru-kg - ru-kz - ru-md - ru-ru - ru-ua - rw - rw-rw - rwk - rwk-tz - sa - sa-in - sah - sah-ru - saq - saq-ke - sat - sat-in - sbp - sbp-tz - sc - sc-it - sd - sd-in - sd-pk - se - se-fi - se-no - se-se - seh - seh-mz - ses - ses-ml - sg - sg-cf - shi - shi-ma - si - si-lk - sk - sk-sk - sl - sl-si - sm - smn - smn-fi - sms - sms-fi - sn - sn-zw - so - so-dj - so-et - so-ke - so-so - sq - sq-al - sq-mk - sq-xk - sr - sr-ba - sr-cs - sr-me - sr-rs - sr-xk - ss - st - st-ls - st-za - su - su-id - sv - sv-ax - sv-fi - sv-se - sw - sw-cd - sw-ke - sw-tz - sw-ug - sy - syr - syr-iq - syr-sy - szl - szl-pl - ta - ta-in - ta-lk - ta-my - ta-sg - te - te-in - teo - teo-ke - teo-ug - tg - tg-tj - th - th-th - ti - ti-er - ti-et - tk - tk-tm - tl - tn - tn-bw - tn-za - to - to-to - tok - tok-001 - tr - tr-cy - tr-tr - ts - tt - tt-ru - tw - twq - twq-ne - ty - tzm - tzm-ma - ug - ug-cn - uk - uk-ua - ur - ur-in - ur-pk - uz - uz-af - uz-uz - vai - vai-lr - ve - vec - vec-it - vi - vi-vn - vmw - vmw-mz - vo - vo-001 - vun - vun-tz - wa - wae - wae-ch - wo - wo-sn - xh - xh-za - xnr - xnr-in - xog - xog-ug - yav - yav-cm - yi - yi-001 - yi-ua - yo - yo-bj - yo-ng - yrl - yrl-br - yrl-co - yrl-ve - yue - yue-cn - yue-hk - yue-mo - za - za-cn - zgh - zgh-ma - zh - zh-cn - zh-hans - zh-hant - zh-hk - zh-mo - zh-my - zh-sg - zh-tw - zu - zu-za name: type: string description: >- Le nom de l'e-mail, tel qu'affiché sur le tableau de bord des e-mails. publishDate: type: string description: "La date et l'heure auxquelles l'e-mail est programmé, suivant le format\_ISO8601. Ceci n'est utilisé que pour les e-mails d'heure locale ou les e-mails programmés." format: date-time rssData: $ref: '#/components/schemas/PublicRssEmailDetails' sendOnPublish: type: boolean description: >- Détermine si l'e-mail sera envoyé immédiatement lors de la publication. state: type: string description: L'état de l'e-mail. enum: - AGENT_GENERATED - AUTOMATED - AUTOMATED_AB - AUTOMATED_AB_VARIANT - AUTOMATED_DRAFT - AUTOMATED_DRAFT_AB - AUTOMATED_DRAFT_ABVARIANT - AUTOMATED_FOR_FORM - AUTOMATED_FOR_FORM_BUFFER - AUTOMATED_FOR_FORM_DRAFT - AUTOMATED_FOR_FORM_LEGACY - AUTOMATED_LOSER_ABVARIANT - AUTOMATED_SENDING - BLOG_EMAIL_DRAFT - BLOG_EMAIL_PUBLISHED - DRAFT - DRAFT_AB - DRAFT_AB_VARIANT - ERROR - LOSER_AB_VARIANT - PAGE_STUB - PRE_PROCESSING - PROCESSING - PUBLISHED - PUBLISHED_AB - PUBLISHED_AB_VARIANT - PUBLISHED_OR_SCHEDULED - RSS_TO_EMAIL_DRAFT - RSS_TO_EMAIL_PUBLISHED - SCHEDULED - SCHEDULED_AB - SCHEDULED_OR_PUBLISHED subcategory: type: string description: La sous-catégorie de l'e-mail. enum: - ab_loser_variant - ab_loser_variant_site_page - ab_master - ab_master_site_page - ab_variant - ab_variant_site_page - automated - automated_ab_master - automated_ab_variant - automated_for_crm - automated_for_custom_survey - automated_for_deal - automated_for_feedback_ces - automated_for_feedback_custom - automated_for_feedback_nps - automated_for_form - automated_for_form_buffer - automated_for_form_draft - automated_for_form_legacy - automated_for_leadflow - automated_for_ticket - batch - blog_article_instance_layout - blog_article_listing - blog_author_detail - blog_email - blog_email_child - case_study - case_study_instance_layout - case_study_listing - discardable_stub - imported_blog_post - kb_404_page - kb_article_instance_layout - kb_listing - kb_search_results - kb_support_form - landing_page - legacy_blog_post - legacy_page - localtime - manage_preferences_email - marketing_single_send_api - membership_email_verification - membership_follow_up - membership_otp_login - membership_password_reset - membership_password_saved - membership_passwordless_auth - membership_registration - membership_registration_follow_up - membership_verification - normal_blog_post - optin_email - optin_followup_email - page_instance_layout - page_stub - performable_landing_page - performable_landing_page_cutover - podcast_instance_layout - podcast_listing - portal_content - resubscribe_confirmation_email - resubscribe_email - rss_to_email - rss_to_email_child - scp_instance_layout_page - scp_static_page - single_send_api - site_page - smtp_token - staged_page - ticket_closed_kickback_email - ticket_opened_kickback_email - ticket_pipeline_automated - UNKNOWN - unsubscribe_confirmation_email - web_interactive subject: type: string description: L'objet de l'e-mail. subscriptionDetails: $ref: '#/components/schemas/PublicEmailSubscriptionDetails' testing: $ref: '#/components/schemas/PublicEmailTestingDetails' to: $ref: '#/components/schemas/PublicEmailToDetails' webversion: $ref: '#/components/schemas/PublicWebversionDetails' PublicEmail: required: - isAb type: object properties: activeDomain: type: string description: Le domaine actif de l'e-mail. allEmailCampaignIds: type: array description: Liste des emailCampaignIds. items: type: string archived: type: boolean description: Détermine si l'e-mail est archivé ou non. businessUnitId: type: string description: L'ID de l'unité commerciale associée à l'e-mail. campaign: type: string description: L'ID de la campagne à laquelle cet e-mail est associé. campaignName: type: string description: Le nom de la campagne campaignUtm: type: string description: Les paramètres UTM associés à la campagne de l'e-mail. clonedFrom: type: string description: L'ID de l'e-mail à partir duquel cet e-mail a été cloné. content: $ref: '#/components/schemas/PublicEmailContent' createdAt: type: string description: "La date et l'heure de création de l'e-mail, au format\_ISO8601." format: date-time createdById: type: string description: L'ID de l'utilisateur qui a créé l'e-mail. deletedAt: type: string description: "La date et l'heure de suppression de l'e-mail, au format\_ISO8601." format: date-time emailCampaignGroupId: type: string description: L'ID du groupe de campagnes e-mail associé à l'e-mail. emailTemplateMode: type: string description: "Le mode du modèle d'e-mail, tel que «\_DESIGN_MANAGER\_» ou «\_DRAG_AND_DROP\_»." enum: - DESIGN_MANAGER - DRAG_AND_DROP feedbackSurveyId: type: string description: L'ID de l'enquête de feedback liée à l'e-mail. folderId: type: integer description: >- Obsolète — ce champ n'est plus fonctionnel. Utiliser folderIdV2 à la place. format: int64 folderIdV2: type: integer description: "L'ID version\_2 du dossier où l'e-mail est stocké, sous forme d'entier 64\_bits." format: int64 from: $ref: '#/components/schemas/PublicEmailFromDetails' id: type: string description: L'ID de l'e-mail. isAb: type: boolean description: Un booléen indiquant si l'e-mail fait partie d'un A/B test. isPublished: type: boolean description: Affiche le statut publié de l'e-mail. En lecture seule. isTransactional: type: boolean description: >- Affiche si l'e-mail est ou non un e-mail transactionnel. En lecture seule. jitterSendTime: type: boolean description: >- Un booléen indiquant s'il faut appliquer une gigue à l'heure d'envoi. language: type: string description: >- Le code de langue de l'e-mail, conformément aux normes ISO 639-1 et ISO 3166-1. enum: - aa - ab - ae - af - af-na - af-za - agq - agq-cm - ak - ak-gh - am - am-et - an - ann - ann-ng - ar - ar-001 - ar-ae - ar-bh - ar-dj - ar-dz - ar-eg - ar-eh - ar-er - ar-il - ar-iq - ar-jo - ar-km - ar-kw - ar-lb - ar-ly - ar-ma - ar-mr - ar-om - ar-ps - ar-qa - ar-sa - ar-sd - ar-so - ar-ss - ar-sy - ar-td - ar-tn - ar-ye - as - as-in - asa - asa-tz - ast - ast-es - av - ay - az - az-az - ba - bal - bal-pk - bas - bas-cm - be - be-by - bem - bem-zm - bez - bez-tz - bg - bg-bg - bgc - bgc-in - bho - bho-in - bi - blo - blo-bj - bm - bm-ml - bn - bn-bd - bn-in - bo - bo-cn - bo-in - br - br-fr - brx - brx-in - bs - bs-ba - ca - ca-ad - ca-es - ca-fr - ca-it - ccp - ccp-bd - ccp-in - ce - ce-ru - ceb - ceb-ph - cgg - cgg-ug - ch - chr - chr-us - ckb - ckb-iq - ckb-ir - co - cr - cs - cs-cz - csw - csw-ca - cu - cu-ru - cv - cv-ru - cy - cy-gb - da - da-dk - da-gl - dav - dav-ke - de - de-at - de-be - de-ch - de-de - de-gr - de-it - de-li - de-lu - dje - dje-ne - doi - doi-in - dsb - dsb-de - dua - dua-cm - dv - dyo - dyo-sn - dz - dz-bt - ebu - ebu-ke - ee - ee-gh - ee-tg - el - el-cy - el-gr - en - en-001 - en-150 - en-ae - en-ag - en-ai - en-as - en-at - en-au - en-bb - en-be - en-bi - en-bm - en-bs - en-bw - en-bz - en-ca - en-cc - en-ch - en-ck - en-cm - en-cn - en-cx - en-cy - en-cz - en-de - en-dg - en-dk - en-dm - en-ee - en-eg - en-er - en-es - en-fi - en-fj - en-fk - en-fm - en-fr - en-gb - en-gd - en-gg - en-gh - en-gi - en-gm - en-gs - en-gu - en-gy - en-hk - en-hu - en-id - en-ie - en-il - en-im - en-in - en-io - en-it - en-je - en-jm - en-ke - en-ki - en-kn - en-ky - en-lc - en-lr - en-ls - en-lu - en-mg - en-mh - en-mo - en-mp - en-ms - en-mt - en-mu - en-mv - en-mw - en-mx - en-my - en-na - en-nf - en-ng - en-nl - en-no - en-nr - en-nu - en-nz - en-pg - en-ph - en-pk - en-pl - en-pn - en-pr - en-pt - en-pw - en-ro - en-rw - en-sb - en-sc - en-sd - en-se - en-sg - en-sh - en-si - en-sk - en-sl - en-ss - en-sx - en-sz - en-tc - en-th - en-tk - en-tn - en-to - en-tt - en-tv - en-tz - en-ug - en-um - en-us - en-vc - en-vg - en-vi - en-vn - en-vu - en-ws - en-za - en-zm - en-zw - eo - eo-001 - es - es-419 - es-ar - es-bo - es-br - es-bz - es-cl - es-co - es-cr - es-cu - es-do - es-ea - es-ec - es-es - es-gq - es-gt - es-hn - es-ic - es-mx - es-ni - es-pa - es-pe - es-ph - es-pr - es-py - es-sv - es-us - es-uy - es-ve - et - et-ee - eu - eu-es - ewo - ewo-cm - fa - fa-af - fa-ir - ff - ff-bf - ff-cm - ff-gh - ff-gm - ff-gn - ff-gw - ff-lr - ff-mr - ff-ne - ff-ng - ff-sl - ff-sn - fi - fi-fi - fil - fil-ph - fj - fo - fo-dk - fo-fo - fr - fr-be - fr-bf - fr-bi - fr-bj - fr-bl - fr-ca - fr-cd - fr-cf - fr-cg - fr-ch - fr-ci - fr-cm - fr-dj - fr-dz - fr-fr - fr-ga - fr-gf - fr-gn - fr-gp - fr-gq - fr-ht - fr-km - fr-lu - fr-ma - fr-mc - fr-mf - fr-mg - fr-ml - fr-mq - fr-mr - fr-mu - fr-nc - fr-ne - fr-pf - fr-pm - fr-re - fr-rw - fr-sc - fr-sn - fr-sy - fr-td - fr-tg - fr-tn - fr-vu - fr-wf - fr-yt - frr - frr-de - fur - fur-it - fy - fy-nl - ga - ga-gb - ga-ie - gaa - gaa-gh - gd - gd-gb - gl - gl-es - gn - gsw - gsw-ch - gsw-fr - gsw-li - gu - gu-in - guz - guz-ke - gv - gv-im - ha - ha-gh - ha-ne - ha-ng - haw - haw-us - he - he-il - hi - hi-in - hmn - ho - hr - hr-ba - hr-hr - hsb - hsb-de - ht - ht-ht - hu - hu-hu - hy - hy-am - hz - ia - ia-001 - id - id-id - ie - ie-ee - ig - ig-ng - ii - ii-cn - ik - io - is - is-is - it - it-ch - it-it - it-sm - it-va - iu - ja - ja-jp - jgo - jgo-cm - jmc - jmc-tz - jv - jv-id - ka - ka-ge - kab - kab-dz - kam - kam-ke - kar - kde - kde-tz - kea - kea-cv - kg - kgp - kgp-br - kh - khq - khq-ml - ki - ki-ke - kj - kk - kk-kz - kkj - kkj-cm - kl - kl-gl - kln - kln-ke - km - km-kh - kn - kn-in - ko - ko-cn - ko-kp - ko-kr - kok - kok-in - kr - ks - ks-in - ksb - ksb-tz - ksf - ksf-cm - ksh - ksh-de - ku - ku-tr - kv - kw - kw-gb - kxv - kxv-in - ky - ky-kg - la - lag - lag-tz - lb - lb-lu - lg - lg-ug - li - lij - lij-it - lkt - lkt-us - lmo - lmo-it - ln - ln-ao - ln-cd - ln-cf - ln-cg - lo - lo-la - lrc - lrc-iq - lrc-ir - lt - lt-lt - lu - lu-cd - luo - luo-ke - luy - luy-ke - lv - lv-lv - mai - mai-in - mas - mas-ke - mas-tz - mdf - mdf-ru - mer - mer-ke - mfe - mfe-mu - mg - mg-mg - mgh - mgh-mz - mgo - mgo-cm - mh - mi - mi-nz - mk - mk-mk - ml - ml-in - mn - mn-mn - mni - mni-in - mr - mr-in - ms - ms-bn - ms-id - ms-my - ms-sg - mt - mt-mt - mua - mua-cm - my - my-mm - mzn - mzn-ir - na - naq - naq-na - nb - nb-no - nb-sj - nd - nd-zw - nds - nds-de - nds-nl - ne - ne-in - ne-np - ng - nl - nl-aw - nl-be - nl-bq - nl-ch - nl-cw - nl-lu - nl-nl - nl-sr - nl-sx - nmg - nmg-cm - nn - nn-no - nnh - nnh-cm - 'no' - no-no - nqo - nqo-gn - nr - nso - nso-za - nus - nus-ss - nv - ny - nyn - nyn-ug - oc - oc-es - oc-fr - oj - om - om-et - om-ke - or - or-in - os - os-ge - os-ru - pa - pa-in - pa-pk - pcm - pcm-ng - pi - pis - pis-sb - pl - pl-pl - prg - prg-001 - ps - ps-af - ps-pk - pt - pt-ao - pt-br - pt-ch - pt-cv - pt-gq - pt-gw - pt-lu - pt-mo - pt-mz - pt-pt - pt-st - pt-tl - qu - qu-bo - qu-ec - qu-pe - raj - raj-in - rm - rm-ch - rn - rn-bi - ro - ro-md - ro-ro - rof - rof-tz - ru - ru-by - ru-kg - ru-kz - ru-md - ru-ru - ru-ua - rw - rw-rw - rwk - rwk-tz - sa - sa-in - sah - sah-ru - saq - saq-ke - sat - sat-in - sbp - sbp-tz - sc - sc-it - sd - sd-in - sd-pk - se - se-fi - se-no - se-se - seh - seh-mz - ses - ses-ml - sg - sg-cf - shi - shi-ma - si - si-lk - sk - sk-sk - sl - sl-si - sm - smn - smn-fi - sms - sms-fi - sn - sn-zw - so - so-dj - so-et - so-ke - so-so - sq - sq-al - sq-mk - sq-xk - sr - sr-ba - sr-cs - sr-me - sr-rs - sr-xk - ss - st - st-ls - st-za - su - su-id - sv - sv-ax - sv-fi - sv-se - sw - sw-cd - sw-ke - sw-tz - sw-ug - sy - syr - syr-iq - syr-sy - szl - szl-pl - ta - ta-in - ta-lk - ta-my - ta-sg - te - te-in - teo - teo-ke - teo-ug - tg - tg-tj - th - th-th - ti - ti-er - ti-et - tk - tk-tm - tl - tn - tn-bw - tn-za - to - to-to - tok - tok-001 - tr - tr-cy - tr-tr - ts - tt - tt-ru - tw - twq - twq-ne - ty - tzm - tzm-ma - ug - ug-cn - uk - uk-ua - ur - ur-in - ur-pk - uz - uz-af - uz-uz - vai - vai-lr - ve - vec - vec-it - vi - vi-vn - vmw - vmw-mz - vo - vo-001 - vun - vun-tz - wa - wae - wae-ch - wo - wo-sn - xh - xh-za - xnr - xnr-in - xog - xog-ug - yav - yav-cm - yi - yi-001 - yi-ua - yo - yo-bj - yo-ng - yrl - yrl-br - yrl-co - yrl-ve - yue - yue-cn - yue-hk - yue-mo - za - za-cn - zgh - zgh-ma - zh - zh-cn - zh-hans - zh-hant - zh-hk - zh-mo - zh-my - zh-sg - zh-tw - zu - zu-za name: type: string description: >- Le nom de l'e-mail, tel qu'affiché sur le tableau de bord des e-mails. previewKey: type: string description: La clé de prévisualisation de l'e-mail. primaryEmailCampaignId: type: string description: L'ID de campagne par e-mail principale associé à l'e-mail. publishDate: type: string description: "La date et l'heure auxquelles l'e-mail est programmé, suivant le format\_ISO8601. Ceci n'est utilisé que pour les e-mails d'heure locale ou les e-mails programmés." format: date-time publishedAt: type: string description: "La date et l'heure de publication de l'e-mail, au format\_ISO8601." format: date-time publishedByEmail: type: string description: E-mail de l'utilisateur qui a publié/envoyé l'e-mail. publishedById: type: string description: L'ID de l'utilisateur qui a publié l'e-mail. publishedByName: type: string description: Nom de l'utilisateur qui a publié l'e-mail. rssData: $ref: '#/components/schemas/PublicRssEmailDetails' sendOnPublish: type: boolean description: >- Détermine si l'e-mail sera envoyé immédiatement lors de la publication. state: type: string description: L'état de l'e-mail. enum: - AGENT_GENERATED - AUTOMATED - AUTOMATED_AB - AUTOMATED_AB_VARIANT - AUTOMATED_DRAFT - AUTOMATED_DRAFT_AB - AUTOMATED_DRAFT_ABVARIANT - AUTOMATED_FOR_FORM - AUTOMATED_FOR_FORM_BUFFER - AUTOMATED_FOR_FORM_DRAFT - AUTOMATED_FOR_FORM_LEGACY - AUTOMATED_LOSER_ABVARIANT - AUTOMATED_SENDING - BLOG_EMAIL_DRAFT - BLOG_EMAIL_PUBLISHED - DRAFT - DRAFT_AB - DRAFT_AB_VARIANT - ERROR - LOSER_AB_VARIANT - PAGE_STUB - PRE_PROCESSING - PROCESSING - PUBLISHED - PUBLISHED_AB - PUBLISHED_AB_VARIANT - PUBLISHED_OR_SCHEDULED - RSS_TO_EMAIL_DRAFT - RSS_TO_EMAIL_PUBLISHED - SCHEDULED - SCHEDULED_AB - SCHEDULED_OR_PUBLISHED stats: $ref: '#/components/schemas/EmailStatisticsData' subcategory: type: string description: La sous-catégorie de l'e-mail. subject: type: string description: L'objet de l'e-mail. subscriptionDetails: $ref: '#/components/schemas/PublicEmailSubscriptionDetails' teamsWithAccess: type: array description: Un tableau d'ID d'équipes ayant accès à l'e-mail. items: type: string testing: $ref: '#/components/schemas/PublicEmailTestingDetails' to: $ref: '#/components/schemas/PublicEmailToDetails' type: type: string description: >- Le type d'e-mail, dérivé d'autres propriétés sur l'e-mail comme la sous-catégorie. enum: - AB_EMAIL - AUTOMATED_AB_EMAIL - AUTOMATED_EMAIL - BATCH_EMAIL - BLOG_EMAIL - BLOG_EMAIL_CHILD - FEEDBACK_CES_EMAIL - FEEDBACK_CUSTOM_EMAIL - FEEDBACK_CUSTOM_SURVEY_EMAIL - FEEDBACK_NPS_EMAIL - FOLLOWUP_EMAIL - LEADFLOW_EMAIL - LOCALTIME_EMAIL - MANAGE_PREFERENCES_EMAIL - MARKETING_SINGLE_SEND_API - MEMBERSHIP_EMAIL_VERIFICATION_EMAIL - MEMBERSHIP_FOLLOW_UP_EMAIL - MEMBERSHIP_OTP_LOGIN_EMAIL - MEMBERSHIP_PASSWORD_RESET_EMAIL - MEMBERSHIP_PASSWORD_SAVED_EMAIL - MEMBERSHIP_PASSWORDLESS_AUTH_EMAIL - MEMBERSHIP_REGISTRATION_EMAIL - MEMBERSHIP_REGISTRATION_FOLLOW_UP_EMAIL - MEMBERSHIP_VERIFICATION_EMAIL - OPTIN_EMAIL - OPTIN_FOLLOWUP_EMAIL - RESUBSCRIBE_EMAIL - RSS_EMAIL - RSS_EMAIL_CHILD - SINGLE_SEND_API - SMTP_TOKEN - TICKET_EMAIL unpublishedAt: type: string description: "La date et l'heure auxquelles la publication de l'e-mail a été annulée, au format ISO\_8601." format: date-time updatedAt: type: string description: "La date et l'heure de la dernière mise à jour de l'e-mail, au format\_ISO8601." format: date-time updatedById: type: string description: L'ID du dernier utilisateur à avoir mis à jour l'e-mail. usersWithAccess: type: array description: Un tableau d'ID utilisateurs ayant accès à l'e-mail. items: type: string webversion: $ref: '#/components/schemas/PublicWebversionDetails' workflowNames: type: array description: "Noms des workflows dans lesquels l'e-mail est utilisé dans une action «\_Envoyer un e-mail\_»." items: type: string PublicEmailContent: type: object properties: flexAreas: type: object additionalProperties: type: object properties: {} description: >- Un objet contenant des configurations de zones flexibles, où chaque clé est un identifiant de zone et la valeur est un objet avec les propriétés de la zone. plainTextVersion: type: string description: Chaîne contenant la version en texte brut du contenu de l'e-mail. smartFields: type: object additionalProperties: $ref: '#/components/schemas/SmartEmailField' description: >- Un objet contenant les configurations de champs intelligents, où chaque clé est un identifiant de champ et la valeur est un objet SmartEmailField. styleSettings: $ref: '#/components/schemas/PublicEmailStyleSettings' templatePath: type: string description: >- Une chaîne représentant le chemin d'accès au modèle d'e-mail utilisé pour cet e-mail. themeSettingsValues: type: object additionalProperties: type: object properties: {} description: >- Un objet contenant les valeurs des paramètres de thème, où chaque clé est un identifiant de paramètre et la valeur est un objet avec les propriétés du paramètre. widgetContainers: type: object additionalProperties: type: object properties: {} description: >- Un objet contenant les configurations des conteneurs de widgets, où chaque clé est un identifiant de conteneur et la valeur est un objet avec les propriétés du conteneur. widgets: type: object additionalProperties: type: object properties: {} description: >- Un objet contenant les configurations de widget, où chaque clé est un identifiant de widget et la valeur est un objet avec les propriétés du widget. PublicEmailFromDetails: type: object properties: customReplyTo: type: string description: La réponse que verront les destinataires. fromName: type: string description: Nom que les destinataires verront. replyTo: type: string description: >- L'adresse de l'expéditeur et l'adresse e-mail de réponse (si aucun customReplyTo n'est défini) que verront les destinataires. PublicRssEmailDetails: type: object properties: blogEmailType: type: string description: Une chaîne représentant le type d'e-mail de blog. blogImageMaxWidth: type: integer description: >- La largeur maximale des images du blog, spécifiée sous forme d'entier. format: int32 blogLayout: type: string description: "La mise en page du blog dans l'e-mail. Les valeurs valides incluent «\_SUMMARY_NO_FEATURED_IMAGE\_», «\_SUMMARY_WITH_FEATURED_IMAGE\_» et «\_FULL_POST\_»." enum: - FULL_POST - SUMMARY_NO_FEATURED_IMAGE - SUMMARY_WITH_FEATURED_IMAGE hubspotBlogId: type: string description: >- L'identifiant unique du blog HubSpot associé à l'e-mail RSS. Il s'agit d'une chaîne de caractères. maxEntries: type: integer description: >- Le nombre maximal d'entrées à inclure dans le fil RSS. Il s'agit d'une valeur entière. format: int32 rssEntryTemplate: type: string description: >- Une chaîne représentant le modèle utilisé pour chaque entrée RSS dans l'e-mail. timing: type: object additionalProperties: type: object properties: {} description: >- Un objet représentant la configuration de la planification pour l'e-mail RSS. Les propriétés spécifiques de cet objet ne sont pas détaillées dans la spécification. url: type: string description: >- L'URL du fil RSS à utiliser dans l'e-mail. Il s'agit d'une chaîne de caractères. useHeadlineAsSubject: type: boolean description: >- Un booléen indiquant s'il faut utiliser le titre de l'entrée RSS comme objet de l'e-mail. PublicEmailSubscriptionDetails: type: object properties: officeLocationId: type: string description: ID de la localisation de bureau sélectionnée. preferencesGroupId: type: string description: >- L'identifiant du groupe de préférences associé à l'abonnement. Il s'agit d'une valeur de type chaîne de caractères. subscriptionId: type: string description: ID de l'abonnement. subscriptionName: type: string description: >- Le nom de l'abonnement aux e-mails. Il s'agit d'une valeur sous forme de chaîne de caractères. PublicEmailTestingDetails: required: - isAbVariation type: object properties: abSampleSizeDefault: type: string description: >- Version de l'e-mail qui doit être envoyée s'il y a trop peu de destinataires pour effectuer un AB test. enum: - automated_loser_variant - automated_master - automated_variant - loser_variant - mab_master - mab_variant - master - variant abSamplingDefault: type: string description: >- Version de l'e-mail à envoyer si les résultats ne sont pas concluants à l'issue de la période de test, principale ou variante. enum: - automated_loser_variant - automated_master - automated_variant - loser_variant - mab_master - mab_variant - master - variant abStatus: type: string description: Statut du test AB. enum: - automated_loser_variant - automated_master - automated_variant - loser_variant - mab_master - mab_variant - master - variant abSuccessMetric: type: string description: >- Indicateur pour déterminer la version qui sera envoyée aux contacts restants enum: - CLICKS_BY_DELIVERED - CLICKS_BY_OPENS - OPENS_BY_DELIVERED abTestPercentage: type: integer description: La taille de votre groupe de test. format: int32 hoursToWait: type: integer description: >- Délai pour recueillir les résultats du test. Une fois ce délai écoulé, la version gagnante sera envoyée aux contacts restants. format: int32 isAbVariation: type: boolean description: "Un booléen indiquant si l'e-mail est une variation d'A/B\_test." testId: type: string description: L'ID du test AB. PublicEmailToDetails: type: object properties: contactIds: $ref: '#/components/schemas/PublicEmailRecipients' contactIlsLists: $ref: '#/components/schemas/PublicEmailRecipients' contactLists: $ref: '#/components/schemas/PublicEmailRecipients' limitSendFrequency: type: boolean description: >- Un booléen indiquant si la fréquence d'envoi des e-mails aux destinataires doit être limitée. suppressGraymail: type: boolean description: Envoyer aux contacts non engagés (faux) ou non (vrai). PublicWebversionDetails: type: object properties: domain: type: string description: >- Chaîne spécifiant le domaine où la version web de l'e-mail est hébergée. enabled: type: boolean description: Un booléen indiquant si la version web de l'e-mail est activée. expiresAt: type: string description: >- Une chaîne de caractères au format date-heure spécifiant la date d'expiration de la page de la version web. format: date-time isPageRedirected: type: boolean description: >- Un booléen indiquant si la page de la version web est redirigée vers une autre URL. metaDescription: type: string description: >- Une chaîne de caractères fournissant la métadescription pour la version web de l'e-mail. pageExpiryEnabled: type: boolean description: >- Un booléen indiquant si une date d'expiration est définie pour la page de la version web. redirectToPageId: type: string description: >- Une chaîne de caractères représentant l'ID de la page vers laquelle la version web est redirigée. redirectToUrl: type: string description: >- Chaîne contenant l'URL vers laquelle la page de la version web est redirigée. slug: type: string description: Chaîne représentant le slug unique de la version web de l’e-mail. title: type: string description: Chaîne représentant le titre de la version web de l'e-mail. url: type: string description: Chaîne contenant l'URL complète de la version web de l'e-mail. EmailStatisticsData: required: - counters - deviceBreakdown - qualifierStats - ratios type: object properties: counters: type: object additionalProperties: type: integer format: int64 description: "Compteurs comme le nombre de «\_envoyés\_», «\_ouverts\_» ou «\_délivrés\_»." deviceBreakdown: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 description: Statistiques par appareil. qualifierStats: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 description: Nombre d'e-mails qui ont été annulés et rejetés. ratios: type: object additionalProperties: type: number description: "Ratios comme «\_openratio\_» ou «\_clickratio\_»" Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base SmartEmailField: type: object properties: {} PublicEmailStyleSettings: type: object properties: backgroundColor: type: string description: >- La couleur d'arrière-plan de l'e-mail, représentée sous forme de chaîne de caractères. backgroundImage: type: string description: L'URL de l'image de fond utilisée dans l'e-mail. backgroundImageType: type: string description: "Le type d'affichage de l'image d'arrière-plan. Les valeurs valides incluent\_: «\_SINGLE\_», «\_STRETCH\_» et «\_REPEAT\_»." enum: - REPEAT - SINGLE - STRETCH bodyBorderColor: type: string description: La couleur de la bordure autour du corps de l’e-mail. bodyBorderColorChoice: type: string description: >- Une chaîne représentant le choix de la couleur de la bordure pour le corps de l'e-mail. bodyBorderWidth: type: number description: >- La largeur de la bordure autour du corps de l'e-mail, représentée par un nombre. bodyColor: type: string description: >- La couleur du corps de l'e-mail, représentée sous forme de chaîne de caractères. buttonStyleSettings: $ref: '#/components/schemas/PublicButtonStyleSettings' colorPickerFavorite1: type: string description: >- Une option de couleur favorite disponible dans le sélecteur de couleurs, représentée sous forme de chaîne de caractères. colorPickerFavorite2: type: string description: >- Une option de couleur favorite disponible dans le sélecteur de couleurs, représentée sous forme de chaîne de caractères. colorPickerFavorite3: type: string description: >- Une option de couleur favorite disponible dans le sélecteur de couleurs, représentée sous forme de chaîne de caractères. colorPickerFavorite4: type: string description: >- Une option de couleur favorite disponible dans le sélecteur de couleurs, représentée sous forme de chaîne de caractères. colorPickerFavorite5: type: string description: >- Une option de couleur préférée disponible dans le sélecteur de couleurs, représentée sous forme de chaîne de caractères. colorPickerFavorite6: type: string description: >- Une option de couleur favorite disponible dans le sélecteur de couleurs, représentée sous forme de chaîne de caractères. dividerStyleSettings: $ref: '#/components/schemas/PublicDividerStyleSettings' emailBodyPadding: type: string description: >- Le remplissage appliqué au corps de l'e-mail, représenté sous forme de chaîne de caractères. emailBodyWidth: type: string description: >- La largeur du corps de l'e-mail, représentée sous forme de chaîne de caractères. headingOneFont: $ref: '#/components/schemas/PublicFontStyle' headingTwoFont: $ref: '#/components/schemas/PublicFontStyle' linksFont: $ref: '#/components/schemas/PublicFontStyle' primaryAccentColor: type: string description: La couleur d'accentuation principale utilisée dans l'e-mail. primaryFont: type: string description: >- La police principale utilisée dans l'e-mail, représentée sous forme de chaîne de caractères. primaryFontColor: type: string description: La couleur de la police principale. primaryFontLineHeight: type: string description: >- La hauteur de ligne de la police principale, représentée sous forme de chaîne de caractères. primaryFontSize: type: number description: La taille de la police principale, représentée par un nombre. secondaryAccentColor: type: string description: La couleur d'accentuation secondaire utilisée dans l'e-mail. secondaryFont: type: string description: >- La police secondaire utilisée dans l'e-mail, représentée sous forme de chaîne de caractères. secondaryFontColor: type: string description: La couleur de la police secondaire. secondaryFontLineHeight: type: string description: >- La hauteur de ligne de la police secondaire, représentée sous forme de chaîne de caractères. secondaryFontSize: type: number description: La taille de la police secondaire, représentée par un nombre. PublicEmailRecipients: type: object properties: exclude: type: array description: ID exclus. items: type: string include: type: array description: ID inclus. items: type: string ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. PublicButtonStyleSettings: type: object properties: backgroundColor: type: object properties: {} description: Un objet représentant la couleur d'arrière-plan du bouton. cornerRadius: type: integer description: Un entier spécifiant le rayon des coins du bouton. format: int32 fontStyle: $ref: '#/components/schemas/PublicFontStyle' PublicDividerStyleSettings: type: object properties: color: type: object properties: {} description: Un objet représentant les paramètres de couleur du séparateur. height: type: integer description: Un entier représentant la hauteur du séparateur. format: int32 lineType: type: string description: Chaîne indiquant le type de ligne utilisé pour le séparateur. PublicFontStyle: type: object properties: bold: type: boolean description: Un booléen indiquant si le texte doit être en gras. color: type: string description: >- La couleur de la police, représentée sous forme de chaîne de caractères. font: type: string description: >- Le type de police à utiliser, représenté sous forme de chaîne de caractères. italic: type: boolean description: Un booléen indiquant si le texte doit être en italique. size: type: integer description: La taille de la police, représentée par un entier. format: int32 underline: type: boolean description: Un booléen indiquant si le texte doit être souligné. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: content: '' marketing-email: '' marketing.email.read: '' marketing.email.write: '' transactional-email: '' ````