Zum Hauptinhalt springen
POST
/
marketing
/
v4
/
email
/
single-send
Envoyer un e-mail
curl --request POST \
  --url https://api.hubapi.com/marketing/v4/email/single-send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customProperties": "{\"customProperty1\":\"value1\",\"customProperty2\":\"value2\"}",
  "emailId": 123,
  "message": {
    "cc": [
      "<string>"
    ],
    "sendId": "<string>",
    "bcc": [
      "<string>"
    ],
    "replyTo": [
      "<string>"
    ],
    "from": "<string>",
    "to": "<string>"
  },
  "contactProperties": "{\"lastname\":\"doe\",\"firstname\":\"john\"}"
}'
{
  "eventId": {
    "created": "2023-11-07T05:31:56Z",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "completedAt": "2023-11-07T05:31:56Z",
  "statusId": "<string>",
  "sendResult": "SENT",
  "requestedAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "message": "<string>",
  "status": "PENDING"
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubEntreprise
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubGratuit

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • marketing-email
  • transactional-email

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

A request to send a single email asynchronously.

​
emailId
integer
required

L'identifiant de contenu pour l'e-mail, qui peut être trouvé dans l'interface utilisateur de l'outil d'e-mail.

​
message
object
required

A JSON object containing anything you want to override.

​
customProperties
object

Le champ personnalisé « Properties » est une carte de valeurs de propriété. Chaque valeur de propriété contient un nom et une propriété de valeur. Chaque propriété sera visible dans le modèle sous {{ custom.NAME }}. Note : les propriétés personnalisées ne prennent actuellement pas en charge les tableaux. Pour fournir une liste dans un e-mail, une solution de contournement consiste à créer une liste HTML (soit avec des tables, soit avec ul) et à la spécifier comme propriété personnalisée.

Example:

"{\"customProperty1\":\"value1\",\"customProperty2\":\"value2\"}"

​
contactProperties
object

Le champ « Propriété de contact » est une carte des valeurs des propriétés de contact. Chaque valeur de propriété de contact contient un nom et une propriété de valeur. Chaque propriété sera définie sur l'enregistrement de contact et sera visible dans le modèle sous {{ contact.NAME }}. Utilisez ces propriétés lorsque vous souhaitez définir une propriété de contact lors de l'envoi de l'e-mail. Par exemple, lors de l'envoi d'un reçu, vous pouvez vouloir définir une propriété last_paid_date, car l'envoi du reçu contiendra des informations sur le dernier paiement.

Example:

"{\"lastname\":\"doe\",\"firstname\":\"john\"}"

Response

successful operation

Describes the status of an email send request.

​
statusId
string
required

Identifiant utilisé pour interroger le statut de l'envoi.

​
status
enum<string>
required

Statut de la demande d'envoi.

Available options:
PENDING,
PROCESSING,
CANCELED,
COMPLETE
​
eventId
object

The ID of a send event.

​
completedAt
string<date-time>

Heure à laquelle l'envoi a été effectué.

​
sendResult
enum<string>

Résultat de l'envoi.

Available options:
SENT,
IDEMPOTENT_IGNORE,
QUEUED,
IDEMPOTENT_FAIL,
THROTTLED,
EMAIL_DISABLED,
PORTAL_SUSPENDED,
INVALID_TO_ADDRESS,
BLOCKED_DOMAIN,
PREVIOUSLY_BOUNCED,
EMAIL_UNCONFIRMED,
PREVIOUS_SPAM,
PREVIOUSLY_UNSUBSCRIBED_MESSAGE,
PREVIOUSLY_UNSUBSCRIBED_PORTAL,
INVALID_FROM_ADDRESS,
CAMPAIGN_CANCELLED,
VALIDATION_FAILED,
MTA_IGNORE,
BLOCKED_ADDRESS,
PORTAL_OVER_LIMIT,
PORTAL_EXPIRED,
PORTAL_MISSING_MARKETING_SCOPE,
MISSING_TEMPLATE_PROPERTIES,
MISSING_REQUIRED_PARAMETER,
PORTAL_AUTHENTICATION_FAILURE,
MISSING_CONTENT,
CORRUPT_INPUT,
TEMPLATE_RENDER_EXCEPTION,
GRAYMAIL_SUPPRESSED,
UNCONFIGURED_SENDING_DOMAIN,
UNDELIVERABLE,
CANCELLED_ABUSE,
QUARANTINED_ADDRESS,
ADDRESS_ONLY_ACCEPTED_ON_PROD,
PORTAL_NOT_AUTHORIZED_FOR_APPLICATION,
ADDRESS_LIST_BOMBED,
ADDRESS_OPTED_OUT,
RECIPIENT_FATIGUE_SUPPRESSED,
TOO_MANY_RECIPIENTS,
PREVIOUSLY_UNSUBSCRIBED_BRAND,
NON_MARKETABLE_CONTACT,
PREVIOUSLY_UNSUBSCRIBED_BUSINESS_UNIT,
GDPR_DOI_ENABLED,
HUBL_LIMIT_EXCEEDED,
LOW_CONTACT_QUALITY_SCORE
​
requestedAt
string<date-time>

Heure à laquelle l'envoi a été demandé.

​
startedAt
string<date-time>

Heure à laquelle l'envoi a commencé à être traité.

​
message
string
⌘I