> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consile.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# HubSpot Marketing Email
> Læs dine marketing-e-mails, kladder, A/B-variationer og post-send-statistik fra HubSpot: plus guardrailet oprettelse og redigering af kladder direkte fra din AI.
HubSpot Marketing Email-connectoren giver din AI adgang til marketing-e-mails i
din egen HubSpot-portal: e-mails og deres kladder, historiske revisioner, A/B-variationer
og aggregeret statistik efter udsendelse. Den kan derudover **oprette og redigere
kladder for dig** bag tydelige sikkerhedsspærrer. Du godkender Consile-appen via
HubSpot-login, og din AI ser aldrig selve adgangstokenet.
**Read + guardrailet skrivning.** Læsning er ren GET. At oprette og redigere
kladder, klone og lave en A/B-variation kører frit, fordi en kladde aldrig
sender til en kontaktliste. Live-redigering (`update_email`), afsendelse,
publicering, annullering, sletning og kassér/gendan kræver din eksplicitte
bekræftelse. Se
[Handlinger & guardrails](/essentials/handlinger-og-guardrails).
Read + guardrailed write
HubSpot-login (OAuth)
Hostet i EU · Frankfurt
* **Pris:** 149 kr/md ekskl. moms (186,25 kr inkl. moms), opsig når som helst.
* **Endpoint:** `https://mcp.consile.ai/hubspot-email/mcp` (din egen, navngivne connector i Claude).
## Forudsætninger
Aktivér din HubSpot Marketing Email-connector i [portalen](https://app.consile.ai). Se
[Tilkøb en connector](/portal/tilkoeb-connector).
Se [Forbind Claude](/connect/forbind-claude).
Log ind med HubSpot og godkend Consile-appen til den portal, du vil forbinde.
Godkendelsen bruger standard OAuth (authorization-code med `refresh_token`).
Access tokens varer ca. 30 minutter og fornyes automatisk i baggrunden, så du
normalt kun godkender én gang.
**Portalkrav (du rammer det ved samtykke).** Den forbundne HubSpot-portal skal
være på **Marketing Hub Professional eller Enterprise**. Scopene `content` og
`marketing-email` findes kun fra Professional og opefter. **Afsendelse og
publicering** kræver derudover **Enterprise eller transactional-email-tilkøbet**.
En Starter- eller Free-portal kan slet ikke give de nødvendige scopes og fejler
allerede ved samtykke.
## Hvad kan den? (tools)
Du behøver ikke kende tool-navnene. Du spørger i naturligt sprog, og din AI vælger
og kalder selv det rigtige værktøj. Transporten navngiver hvert værktøj som
`hubspot-email__` (fx `hubspot-email__list_emails`); herunder vises de bare
navne for læsbarhed.
Connectoren stiller i alt **19 værktøjer** til rådighed: **8 read-only** (ren
læsning) og **11 skrive-værktøjer**. Af skrive-værktøjerne kører de 4 kladde-handlinger
frit, og de 7 der rører den live e-mail, sender eller kasserer arbejde kræver en
bekræftelse.
### Læsning (8 read-only)
**E-mails, kladder og revisioner**
| Tool | Hvad den gør |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_emails` | Marketing-e-mails med paging og filtre (type, kampagne, publiceret/arkiveret, tidsvinduer); `includeStats:true` tilføjer post-send-statistik pr. e-mail |
| `get_email` | Fuld detalje for én e-mail (den live/aktuelle version); `includeStats` for statistik, `variantStats` for stats pr. A/B-variant |
| `get_email_draft` | Den aktuelle, ikke-publicerede kladde (arbejdskopien) af en e-mail, så du kan se afventende ændringer |
| `list_email_revisions` | Historiske revisioner (versions-snapshots) af en e-mail, med paging |
| `get_email_revision` | Én historisk revision af en e-mail, slået op på revisions-id |
| `get_email_ab_variation` | Den modsatte A/B-variation af en A/B-e-mail: får du A, returnerer den B og omvendt |
**Statistik**
| Tool | Hvad den gør |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_email_statistics` | Aggregeret post-send-statistik (sendt, leveret, åbnet, klik, bounce, plus ratioer) på tværs af e-mails sendt i et tidsrum, samt listen af sendte e-mail-id'er. Svarer til Email Performance-siden i HubSpot |
| `get_email_statistics_histogram` | Samme statistik tids-bucketet over et tidsrum ved et valgt interval (fx DAY/WEEK/MONTH) |
### Skrivning (11 værktøjer)
Disse værktøjer er de eneste, der ændrer noget i din HubSpot-portal. De fire
kladde-handlinger kører frit, fordi de kun rører en kladde (en arbejdskopi) eller
laver et nyt udkast: en kladde sender aldrig til en kontaktliste. De syv øvrige
rører den live e-mail, sender, annullerer, arkiverer eller kasserer/gendanner arbejde,
og kræver derfor `confirm: true`. Uden bekræftelse får du kun en forhåndsvisning
(dry-run), og der sendes intet til HubSpot.
**Kladde, redigér, klon og A/B (kører frit)**
| Tool | Hvad den gør | Kræver bekræftelse? |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------- |
| `create_email` | Opretter en ny marketing-e-mail. Tilstanden tvinges til DRAFT, så den hverken publiceres eller sendes ved oprettelse | Nej |
| `update_email_draft` | Opretter eller opdaterer kun kladden (arbejdskopien) uden at røre den live version. Publicerer eller sender ikke | Nej |
| `clone_email` | Kloner en eksisterende e-mail til en ny kladde, evt. med nyt navn og sprog | Nej |
| `create_email_ab_variation` | Opretter en A/B-test-variation som en kladde-variant. Sender ikke | Nej |
**Live-redigering, send, annullér, arkivér og gendan (kræver bekræftelse)**
| Tool | Hvad den gør | Kræver bekræftelse? |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| `update_email` | Sparse-opdatering af den live/aktuelle version (navn, emne, afsender, modtagere, indhold, kampagne, mappe, sprog). Sender ikke, men kan ændre målgruppe eller indhold på en allerede publiceret eller planlagt e-mail | Ja |
| `publish_email` | Publicerer/sender e-mailen til de konfigurerede modtagere. Højeste risiko: sender rigtig e-mail til kontaktlisterne | Ja (altid) |
| `unpublish_email` | Afpublicerer en publiceret e-mail eller annullerer en planlagt afsendelse | Ja |
| `delete_email` | Sletter (arkiverer) en marketing-e-mail | Ja |
| `reset_email_draft` | Kasserer ugemte kladde-ændringer og nulstiller kladden til seneste publicerede version | Ja |
| `restore_email_revision_to_draft` | Kopierer en tidligere revisions indhold ind i kladden (publicerer ikke), men overskriver kladde-bufferen | Ja |
| `restore_email_revision` | Gendanner en tidligere revision som ny aktuel version (erstatter den live version) | Ja |
Fuld reference med argumenter, paging, filtre, guardrail-felter og returværdier
for hvert tool.
## Sådan virker guardrailen
Sikkerheden er bygget ind i selve connectoren som standardindstillinger, ikke en
ubrydelig platform-spærre:
1. **Kladder er sikre og kører frit.** At oprette eller redigere en kladde, klone
en e-mail eller lave en A/B-variation rører aldrig den live e-mail og sender aldrig
til en kontaktliste. Nye e-mails tvinges til tilstand `DRAFT`, og hverken `create_email`
eller `update_email_draft` accepterer et felt, der kan publicere eller planlægge
en afsendelse.
2. **Send, live-ændring og kassér kræver `confirm: true`.** At publicere/sende,
afpublicere/annullere, slette/arkivere, redigere den live version eller kassere/gendanne
arbejde kræver, at din AI sender en eksplicit bekræftelse. Uden den får du en
struktureret forhåndsvisning af præcis hvad der ville ske, og **intet** kald sendes
til HubSpot.
3. **Afsendelse går kun gennem ét værktøj.** Rigtig e-mail til kontaktlisterne kan
kun nås via det bekræftede `publish_email`. Oprettelse og kladde-redigering bærer
aldrig en tilstand, der publicerer eller planlægger en afsendelse.
I praksis viser din AI dig planen først. Den anden, bekræftede handling er den, der
faktisk sender eller rører den live e-mail.
Læs hele bekræftelses-modellen, der gælder på tværs af alle skrive-connectors,
under [Handlinger & guardrails](/essentials/handlinger-og-guardrails).
## Prøv at spørge
> *"Vis mine 20 seneste marketing-e-mails med type og publiceringsstatus."*
> *"Hvilke e-mails er stadig kladder, og hvilke er publiceret?"*
> *"Find e-mails opdateret i sidste uge."*
> *"Hvad er åbnings- og klikraten for e-mails sendt i maj?"*
> *"Vis ugentlig udvikling i leverede og klik for de seneste tre måneder."*
> *"Hvordan klarer variant B sig mod A på den seneste A/B-e-mail?"*
> *"Lav et udkast til en nyhedsbrev-e-mail med emnet 'Forår 2026' og dansk sprog."*
> *"Klon e-mail 1234 som 'Forår 2026 variant'."*
> *"Hvad står der i den nuværende kladde af e-mail 1234, og hvilke revisioner findes?"*
> *"Publicér e-mail 1234 til de konfigurerede modtagere."* (du får en forhåndsvisning og skal bekræfte, før den sender)
> *"Annullér den planlagte afsendelse af e-mail 5678."* (du bliver bedt om at bekræfte)
> *"Skift afsendernavnet på den publicerede e-mail 1234."* (du får en forhåndsvisning og skal bekræfte)
Nævn gerne et datointerval (eller fx "sidste 30 dage") i statistik-spørgsmål, så
bliver svaret præcist med det samme.
## Begrænsninger
* **Kræver Marketing Hub Professional eller Enterprise.** Scopene `content` og
`marketing-email` findes ikke på Starter eller Free, så en sådan portal fejler
allerede ved samtykke. Afsendelse og publicering kræver desuden Enterprise eller
transactional-email-tilkøbet; uden det svarer HubSpot med en 403.
* **Skrivning er guardrailet, ikke fri.** De live-handlinger, der sender, annullerer,
arkiverer eller kasserer arbejde, kan kun køre bag bekræftelses-spærren ovenfor.
Guardrailen er sikre standardindstillinger i connectoren, ikke en absolut garanti. Se
[Handlinger & guardrails](/essentials/handlinger-og-guardrails).
* **Statistik er aggregeret.** Connectoren læser post-send-statistik på tværs af
e-mails (tællere, ratioer, histogram). Den henter ikke individuelle modtager-events.
* **Frakobling.** Der er ingen upstream-revoke i portalen i v1. For at trække
adgangen tilbage afinstallerer du Consile-appen inde i HubSpot. At afbryde
connectoren i Consile-portalen sletter det gemte token med det samme.
Virker noget ikke som forventet? Se [Fejlfinding](/troubleshooting).