Account & Settings
App-Verwaltung
Authentifizierung
Automatisierung
CMS
Communication preferences
Konversationen
Veranstaltungen
Dateien
Scheduler
curl --request POST \
--url https://api.hubapi.com/marketing/transactional/2026-03/single-email/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contactProperties": {},
"customProperties": {},
"emailId": 123,
"message": {
"bcc": [
"<string>"
],
"cc": [
"<string>"
],
"replyTo": [
"<string>"
],
"from": "<string>",
"sendId": "<string>",
"to": "<string>"
}
}
'{
"statusId": "<string>",
"completedAt": "2023-11-07T05:31:56Z",
"eventId": {
"created": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"message": "<string>",
"requestedAt": "2023-11-07T05:31:56Z",
"startedAt": "2023-11-07T05:31:56Z"
}Send a transactional email
Senden Sie eine Transaktions-E-Mail asynchron. Gibt den Status des E-Mail-Versands mit einer „statusId“ zurück, die zum kontinuierlichen Abfragen des Status über die E-Mail-Sendestatus-API verwendet werden kann.
curl --request POST \
--url https://api.hubapi.com/marketing/transactional/2026-03/single-email/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contactProperties": {},
"customProperties": {},
"emailId": 123,
"message": {
"bcc": [
"<string>"
],
"cc": [
"<string>"
],
"replyTo": [
"<string>"
],
"from": "<string>",
"sendId": "<string>",
"to": "<string>"
}
}
'{
"statusId": "<string>",
"completedAt": "2023-11-07T05:31:56Z",
"eventId": {
"created": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"message": "<string>",
"requestedAt": "2023-11-07T05:31:56Z",
"startedAt": "2023-11-07T05:31:56Z"
}Documentation Index
Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt
Use this file to discover all available pages before exploring further.
Supported products
Supported products
Required Scopes
Required Scopes
Autorisierungen
The access token received from the authorization server in the OAuth 2.0 flow.
Body
Das „contactProperties“-Feld ist eine Karte von Kontakteigenschaftswerten. Jeder Kontakteigenschaftswert enthält eine Namens- und eine Werteigenschaft. Jede Eigenschaft wird im Kontaktdatensatz festgelegt und ist in der Vorlage unter {{ contact.NAME }} sichtbar. Verwenden Sie diese Eigenschaften, wenn Sie eine Kontakteigenschaft während des Sendens der E-Mail festlegen möchten. Legen Sie z. B. beim Senden einer Quittung die „last_paid_date“-Eigenschaft fest, da Informationen über die letzte Zahlung enthalten sein werden.
Show child attributes
Show child attributes
Das Feld „customProperties“ ist eine Karte mit Eigenschaftswerten. Jeder Eigenschaftswert enthält eine Namens- und eine Werteigenschaft. Alle Eigenschaften werden in der Vorlage unter {{ custom.NAME }} angezeigt. Hinweis: Benutzerdefinierte Eigenschaften unterstützen derzeit keine Arrays. Um ein Listing in einer E-Mail bereitzustellen, kann eine HTML-Liste (entweder mit Tabellen oder ul) erstellt und als benutzerdefinierte Eigenschaft spezifiziert werden.
Show child attributes
Show child attributes
Die Content-ID für die Transaktions-E-Mail, die in der E-Mail-Tool-UI zu finden sind.
Show child attributes
Show child attributes
Antwort
successful operation
Status der Sendeanfrage.
CANCELED, COMPLETE, PENDING, PROCESSING ID für die Abfrage des Sendestatus.
Zeitpunkt, an dem der Versand abgeschlossen wurde.
Show child attributes
Show child attributes
Eine für Menschen lesbare Nachricht mit einer Beschreibung des Fehlers und ggf. Abhilfemaßnahmen
Zeitpunkt, an dem der Versand angefordert wurde.
Ergebnis des Sendevorgangs.
ADDRESS_LIST_BOMBED, ADDRESS_ONLY_ACCEPTED_ON_PROD, ADDRESS_OPTED_OUT, ATTACHMENT_DOWNLOAD_QUEUE_FULL, BLOCKED_ADDRESS, BLOCKED_DOMAIN, BRAND_RECIPIENT_FATIGUE_SUPPRESSED, CAMPAIGN_CANCELLED, CANCELLED_ABUSE, CONTACT_VIEW_PERMISSION, CORRUPT_INPUT, EMAIL_DISABLED, EMAIL_UNCONFIRMED, GDPR_DOI_ENABLED, GRAYMAIL_SUPPRESSED, HUBL_LIMIT_EXCEEDED, IDEMPOTENT_FAIL, IDEMPOTENT_IGNORE, INVALID_APP_ID_ATTRIBUTION, INVALID_FROM_ADDRESS, INVALID_TO_ADDRESS, LOW_CONTACT_QUALITY_SCORE, MISSING_CONTENT, MISSING_REQUIRED_PARAMETER, MISSING_TEMPLATE_PROPERTIES, MTA_IGNORE, NON_MARKETABLE_CONTACT, PORTAL_AUTHENTICATION_FAILURE, PORTAL_EXPIRED, PORTAL_MISSING_MARKETING_SCOPE, PORTAL_NOT_AUTHORIZED_FOR_APPLICATION, PORTAL_OVER_LIMIT, PORTAL_SUSPENDED, PREVIOUS_SPAM, PREVIOUSLY_BOUNCED, PREVIOUSLY_UNSUBSCRIBED_BRAND, PREVIOUSLY_UNSUBSCRIBED_BUSINESS_UNIT, PREVIOUSLY_UNSUBSCRIBED_MESSAGE, PREVIOUSLY_UNSUBSCRIBED_PORTAL, QUARANTINED_ADDRESS, QUEUED, RECIPIENT_FATIGUE_SUPPRESSED, SENT, TEMPLATE_RENDER_EXCEPTION, THROTTLED, TOO_MANY_RECIPIENTS, UBB_GOVERNANCE_MISSING, UNCONFIGURED_SENDING_DOMAIN, UNDELIVERABLE, VALIDATION_FAILED Der Zeitpunkt, ab dem der Versand bearbeitet wurde.