Created
March 20, 2023 18:28
-
-
Save jonowar/baacbc46cb35c350a75b9d9fc564024b to your computer and use it in GitHub Desktop.
Sparkpost Webhook Events Documentation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
{ | |
"message_event": { | |
"events": { | |
"bounce": { | |
"event": { | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"bounce_class": { | |
"description": "Classification code for a given message (see [Bounce Classification Codes](https://support.sparkpost.com/customer/portal/articles/1929896))", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"device_token": { | |
"description": "Token of the device / application targeted by this PUSH notification message. Applies only when delv_method is gcm or apn.", | |
"sampleValue": "45c19189783f867973f6e6a5cca60061ffe4fa77c547150563a1192fa9847f8a" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"sms_coding": { | |
"description": "Data encoding used in the SMS message", | |
"sampleValue": "ASCII" | |
}, | |
"sms_dst": { | |
"description": "SMS destination address", | |
"sampleValue": "7876712656" | |
}, | |
"sms_dst_npi": { | |
"description": "Destination numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_dst_ton": { | |
"description": "Type of number for the destination address", | |
"sampleValue": "International" | |
}, | |
"sms_src": { | |
"description": "SMS source address", | |
"sampleValue": "1234" | |
}, | |
"sms_src_npi": { | |
"description": "Source numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_src_ton": { | |
"description": "Type of number for the source address", | |
"sampleValue": "Unknown" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "bounce" | |
} | |
}, | |
"description": "Remote MTA has permanently rejected a message.", | |
"display_name": "Bounce" | |
}, | |
"delivery": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"device_token": { | |
"description": "Token of the device / application targeted by this PUSH notification message. Applies only when delv_method is gcm or apn.", | |
"sampleValue": "45c19189783f867973f6e6a5cca60061ffe4fa77c547150563a1192fa9847f8a" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"outbound_tls": { | |
"description": "Whether a message was sent using TLS or not. Specifies if a message wasn't sent with TLS either because no TLS was offered or TLS negotiation failed. 1 means TLS was used, 0 means TLS was not offered, -1 means TLS negotiation failed", | |
"sampleValue": "-1" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"sms_coding": { | |
"description": "Data encoding used in the SMS message", | |
"sampleValue": "ASCII" | |
}, | |
"sms_dst": { | |
"description": "SMS destination address", | |
"sampleValue": "7876712656" | |
}, | |
"sms_dst_npi": { | |
"description": "Destination numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_dst_ton": { | |
"description": "Type of number for the destination address", | |
"sampleValue": "International" | |
}, | |
"sms_remoteids": { | |
"description": "The message ID(s) in the response, assigned by the remote server/SMSC", | |
"sampleValue": [ | |
"0000", | |
"0001", | |
"0002", | |
"0003", | |
"0004" | |
] | |
}, | |
"sms_segments": { | |
"description": "Segment number of the log line for large messages sent through multiple SMSes", | |
"sampleValue": 5 | |
}, | |
"sms_src": { | |
"description": "SMS source address", | |
"sampleValue": "1234" | |
}, | |
"sms_src_npi": { | |
"description": "Source numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_src_ton": { | |
"description": "Type of number for the source address", | |
"sampleValue": "Unknown" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "delivery" | |
} | |
}, | |
"description": "Remote MTA acknowledged receipt of a message.", | |
"display_name": "Delivery" | |
}, | |
"injection": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"sms_coding": { | |
"description": "Data encoding used in the SMS message", | |
"sampleValue": "ASCII" | |
}, | |
"sms_dst": { | |
"description": "SMS destination address", | |
"sampleValue": "7876712656" | |
}, | |
"sms_dst_npi": { | |
"description": "Destination numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_dst_ton": { | |
"description": "Type of number for the destination address", | |
"sampleValue": "International" | |
}, | |
"sms_segments": { | |
"description": "Segment number of the log line for large messages sent through multiple SMSes", | |
"sampleValue": 5 | |
}, | |
"sms_src": { | |
"description": "SMS source address", | |
"sampleValue": "1234" | |
}, | |
"sms_src_npi": { | |
"description": "Source numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_src_ton": { | |
"description": "Type of number for the source address", | |
"sampleValue": "Unknown" | |
}, | |
"sms_text": { | |
"description": "The SMS message payload (in the character set specified in sms_coding)", | |
"sampleValue": "lol" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "injection" | |
} | |
}, | |
"description": "Message is received by or injected into SparkPost.", | |
"display_name": "Injection" | |
}, | |
"sms_status": { | |
"event": { | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"dr_latency": { | |
"description": "Delivery report latency; interval between message submission and receipt", | |
"sampleValue": "0.02" | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"sms_dst": { | |
"description": "SMS destination address", | |
"sampleValue": "7876712656" | |
}, | |
"sms_dst_npi": { | |
"description": "Destination numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_dst_ton": { | |
"description": "Type of number for the destination address", | |
"sampleValue": "International" | |
}, | |
"sms_remoteids": { | |
"description": "The message ID(s) in the response, assigned by the remote server/SMSC", | |
"sampleValue": [ | |
"0000", | |
"0001", | |
"0002", | |
"0003", | |
"0004" | |
] | |
}, | |
"sms_src": { | |
"description": "SMS source address", | |
"sampleValue": "1234" | |
}, | |
"sms_src_npi": { | |
"description": "Source numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_src_ton": { | |
"description": "Type of number for the source address", | |
"sampleValue": "Unknown" | |
}, | |
"sms_text": { | |
"description": "The SMS message payload (in the character set specified in sms_coding)", | |
"sampleValue": "lol" | |
}, | |
"stat_type": { | |
"description": "Status type in an SMS status event", | |
"sampleValue": "SMSC Delivery" | |
}, | |
"stat_state": { | |
"description": "Status value in an SMS status event", | |
"sampleValue": "Delivered" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "sms_status" | |
} | |
}, | |
"description": "SMPP/SMS message produced a status log output", | |
"display_name": "SMS Status" | |
}, | |
"spam_complaint": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"fbtype": { | |
"description": "Type of spam report entered against this message (see [RFC 5965 § 7.3](http://tools.ietf.org/html/rfc5965#section-7.3))", | |
"sampleValue": "abuse" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"report_by": { | |
"description": "Address of the entity reporting this message as spam", | |
"sampleValue": "server.email.com" | |
}, | |
"report_to": { | |
"description": "Address to which this spam report is to be delivered", | |
"sampleValue": "abuse.example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "spam_complaint" | |
} | |
}, | |
"description": "Message was classified as spam by the recipient.", | |
"display_name": "Spam Complaint" | |
}, | |
"out_of_band": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"bounce_class": { | |
"description": "Classification code for a given message (see [Bounce Classification Codes](https://support.sparkpost.com/customer/portal/articles/1929896))", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"device_token": { | |
"description": "Token of the device / application targeted by this PUSH notification message. Applies only when delv_method is gcm or apn.", | |
"sampleValue": "45c19189783f867973f6e6a5cca60061ffe4fa77c547150563a1192fa9847f8a" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "out_of_band" | |
} | |
}, | |
"description": "Remote MTA initially reported acceptance of a message, but it has since asynchronously reported that the message was not delivered.", | |
"display_name": "Out of Band" | |
}, | |
"policy_rejection": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"remote_addr": { | |
"description": "IP address of the host from which SparkPost received this message", | |
"sampleValue": "18.236.253.72" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "policy_rejection" | |
}, | |
"bounce_class": { | |
"description": "Classification code for a given message (see [Bounce Classification Codes](https://support.sparkpost.com/customer/portal/articles/1929896))", | |
"sampleValue": "25" | |
} | |
}, | |
"description": "Due to policy, SparkPost rejected a message or failed to generate a message.", | |
"display_name": "Policy Rejection" | |
}, | |
"delay": { | |
"event": { | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"bounce_class": { | |
"description": "Classification code for a given message (see [Bounce Classification Codes](https://support.sparkpost.com/customer/portal/articles/1929896))", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"device_token": { | |
"description": "Token of the device / application targeted by this PUSH notification message. Applies only when delv_method is gcm or apn.", | |
"sampleValue": "45c19189783f867973f6e6a5cca60061ffe4fa77c547150563a1192fa9847f8a" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"outbound_tls": { | |
"description": "Whether a message was sent using TLS or not. Specifies if a message wasn't sent with TLS either because no TLS was offered or TLS negotiation failed. 1 means TLS was used, 0 means TLS was not offered, -1 means TLS negotiation failed", | |
"sampleValue": "-1" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"sms_coding": { | |
"description": "Data encoding used in the SMS message", | |
"sampleValue": "ASCII" | |
}, | |
"sms_dst": { | |
"description": "SMS destination address", | |
"sampleValue": "7876712656" | |
}, | |
"sms_dst_npi": { | |
"description": "Destination numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_dst_ton": { | |
"description": "Type of number for the destination address", | |
"sampleValue": "International" | |
}, | |
"sms_src": { | |
"description": "SMS source address", | |
"sampleValue": "1234" | |
}, | |
"sms_src_npi": { | |
"description": "Source numbering plan identification", | |
"sampleValue": "E164" | |
}, | |
"sms_src_ton": { | |
"description": "Type of number for the source address", | |
"sampleValue": "Unknown" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "delay" | |
} | |
}, | |
"description": "Remote MTA has temporarily rejected a message.", | |
"display_name": "Delay" | |
} | |
}, | |
"description": "Message events describe the life cycle of a message including injection, delivery, and disposition.", | |
"display_name": "Message Events" | |
}, | |
"track_event": { | |
"events": { | |
"click": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"geo_ip": { | |
"description": "Geographic location based on the IP address, including latitude, longitude, city, country, region, and zip", | |
"sampleValue": { | |
"country": "US", | |
"region": "MD", | |
"city": "Columbia", | |
"latitude": 39.1749, | |
"longitude": -76.8375, | |
"zip": 21046, | |
"postal_code": "21046" | |
} | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"target_link_name": { | |
"description": "Name of the link for which a click event was generated", | |
"sampleValue": "Example Link Name" | |
}, | |
"target_link_url": { | |
"description": "URL of the link for which a click event was generated", | |
"sampleValue": "http://example.com" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "click" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
}, | |
"user_agent_parsed": { | |
"description": "Parsed User-Agent information, including device and OS information. `is_mobile` indicates whether the device is a mobile device. `is_proxy` indicates whether the User-Agent is a proxy server. `is_prefetched` indicates if this event was likely prefetched, for example through Apple MPP. This field does not apply to clicks - the value returned in click events is always false.", | |
"sampleValue": { | |
"agent_family": "WebKit", | |
"device_brand": "Apple", | |
"device_family": "iPhone", | |
"os_family": "iOS", | |
"os_version": "14", | |
"is_mobile": true, | |
"is_proxy": false, | |
"is_prefetched": false | |
} | |
} | |
}, | |
"description": "Recipient clicked a tracked link in a message, thus prompting a redirect through the SparkPost click-tracking server to the link's destination.", | |
"display_name": "Click" | |
}, | |
"open": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"geo_ip": { | |
"description": "Geographic location based on the IP address, including latitude, longitude, city, country, region, and zip", | |
"sampleValue": { | |
"country": "US", | |
"region": "MD", | |
"city": "Columbia", | |
"latitude": 39.1749, | |
"longitude": -76.8375, | |
"zip": 21046, | |
"postal_code": "21046" | |
} | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "open" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
}, | |
"user_agent_parsed": { | |
"description": "Parsed User-Agent information, including device and OS information. `is_mobile` indicates whether the device is a mobile device. `is_proxy` indicates whether the User-Agent is a proxy server. `is_prefetched` indicates if this event was likely prefetched, for example through Apple MPP. This field does not apply to clicks - the value returned in click events is always false.", | |
"sampleValue": { | |
"agent_family": "WebKit", | |
"device_brand": "Apple", | |
"device_family": "iPhone", | |
"os_family": "iOS", | |
"os_version": "14", | |
"is_mobile": true, | |
"is_proxy": false, | |
"is_prefetched": false | |
} | |
} | |
}, | |
"description": "Recipient opened a message in a mail client, thus rendering a tracking pixel at the bottom of the message.", | |
"display_name": "Open" | |
}, | |
"initial_open": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"geo_ip": { | |
"description": "Geographic location based on the IP address, including latitude, longitude, city, country, region, and zip", | |
"sampleValue": { | |
"country": "US", | |
"region": "MD", | |
"city": "Columbia", | |
"latitude": 39.1749, | |
"longitude": -76.8375, | |
"zip": 21046, | |
"postal_code": "21046" | |
} | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "initial_open" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
}, | |
"user_agent_parsed": { | |
"description": "Parsed User-Agent information, including device and OS information. `is_mobile` indicates whether the device is a mobile device. `is_proxy` indicates whether the User-Agent is a proxy server. `is_prefetched` indicates if this event was likely prefetched, for example through Apple MPP. This field does not apply to clicks - the value returned in click events is always false.", | |
"sampleValue": { | |
"agent_family": "WebKit", | |
"device_brand": "Apple", | |
"device_family": "iPhone", | |
"os_family": "iOS", | |
"os_version": "14", | |
"is_mobile": true, | |
"is_proxy": false, | |
"is_prefetched": false | |
} | |
} | |
}, | |
"description": "Recipient opened a message in a mail client, thus rendering a tracking pixel at the top of the message.", | |
"display_name": "Initial Open" | |
}, | |
"amp_click": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"geo_ip": { | |
"description": "Geographic location based on the IP address, including latitude, longitude, city, country, region, and zip", | |
"sampleValue": { | |
"country": "US", | |
"region": "MD", | |
"city": "Columbia", | |
"latitude": 39.1749, | |
"longitude": -76.8375, | |
"zip": 21046, | |
"postal_code": "21046" | |
} | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"target_link_name": { | |
"description": "Name of the link for which a click event was generated", | |
"sampleValue": "Example Link Name" | |
}, | |
"target_link_url": { | |
"description": "URL of the link for which a click event was generated", | |
"sampleValue": "http://example.com" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "amp_click" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
}, | |
"user_agent_parsed": { | |
"description": "Parsed User-Agent information, including device and OS information. `is_mobile` indicates whether the device is a mobile device. `is_proxy` indicates whether the User-Agent is a proxy server. `is_prefetched` indicates if this event was likely prefetched, for example through Apple MPP. This field does not apply to clicks - the value returned in click events is always false.", | |
"sampleValue": { | |
"agent_family": "WebKit", | |
"device_brand": "Apple", | |
"device_family": "iPhone", | |
"os_family": "iOS", | |
"os_version": "14", | |
"is_mobile": true, | |
"is_proxy": false, | |
"is_prefetched": false | |
} | |
} | |
}, | |
"description": "Recipient clicked a tracked link in an AMP message, thus prompting a redirect through the SparkPost click-tracking server to the link's destination.", | |
"display_name": "AMP Click" | |
}, | |
"amp_open": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"geo_ip": { | |
"description": "Geographic location based on the IP address, including latitude, longitude, city, country, region, and zip", | |
"sampleValue": { | |
"country": "US", | |
"region": "MD", | |
"city": "Columbia", | |
"latitude": 39.1749, | |
"longitude": -76.8375, | |
"zip": 21046, | |
"postal_code": "21046" | |
} | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "amp_open" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
}, | |
"user_agent_parsed": { | |
"description": "Parsed User-Agent information, including device and OS information. `is_mobile` indicates whether the device is a mobile device. `is_proxy` indicates whether the User-Agent is a proxy server. `is_prefetched` indicates if this event was likely prefetched, for example through Apple MPP. This field does not apply to clicks - the value returned in click events is always false.", | |
"sampleValue": { | |
"agent_family": "WebKit", | |
"device_brand": "Apple", | |
"device_family": "iPhone", | |
"os_family": "iOS", | |
"os_version": "14", | |
"is_mobile": true, | |
"is_proxy": false, | |
"is_prefetched": false | |
} | |
} | |
}, | |
"description": "Recipient opened an AMP message in a mail client, thus rendering a tracking pixel at the bottom of the message.", | |
"display_name": "AMP Open" | |
}, | |
"amp_initial_open": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"geo_ip": { | |
"description": "Geographic location based on the IP address, including latitude, longitude, city, country, region, and zip", | |
"sampleValue": { | |
"country": "US", | |
"region": "MD", | |
"city": "Columbia", | |
"latitude": 39.1749, | |
"longitude": -76.8375, | |
"zip": 21046, | |
"postal_code": "21046" | |
} | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "amp_initial_open" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
}, | |
"user_agent_parsed": { | |
"description": "Parsed User-Agent information, including device and OS information. `is_mobile` indicates whether the device is a mobile device. `is_proxy` indicates whether the User-Agent is a proxy server. `is_prefetched` indicates if this event was likely prefetched, for example through Apple MPP. This field does not apply to clicks - the value returned in click events is always false.", | |
"sampleValue": { | |
"agent_family": "WebKit", | |
"device_brand": "Apple", | |
"device_family": "iPhone", | |
"os_family": "iOS", | |
"os_version": "14", | |
"is_mobile": true, | |
"is_proxy": false, | |
"is_prefetched": false | |
} | |
} | |
}, | |
"description": "Recipient opened an AMP message in a mail client, thus rendering a tracking pixel at the top of the message.", | |
"display_name": "AMP Initial Open" | |
} | |
}, | |
"description": "Engagement events describe the behavior of a recipient with respect to the message sent.", | |
"display_name": "Engagement Events" | |
}, | |
"gen_event": { | |
"events": { | |
"generation_failure": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_subs": { | |
"description": "Substitutions applied to the template to construct this message", | |
"sampleValue": { | |
"country": "US", | |
"gender": "Female" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "generation_failure" | |
} | |
}, | |
"description": "Message generation failed for an intended recipient.", | |
"display_name": "Generation Failure" | |
}, | |
"generation_rejection": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_subs": { | |
"description": "Substitutions applied to the template to construct this message", | |
"sampleValue": { | |
"country": "US", | |
"gender": "Female" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "generation_rejection" | |
}, | |
"bounce_class": { | |
"description": "Classification code for a given message (see [Bounce Classification Codes](https://support.sparkpost.com/customer/portal/articles/1929896))", | |
"sampleValue": "25" | |
} | |
}, | |
"description": "SparkPost rejected message generation due to policy.", | |
"display_name": "Generation Rejection" | |
} | |
}, | |
"description": "Generation events provide insight into message generation failures or rejections.", | |
"display_name": "Generation Events" | |
}, | |
"unsubscribe_event": { | |
"events": { | |
"list_unsubscribe": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"mailfrom": { | |
"description": "Envelope mailfrom of the original email", | |
"sampleValue": "recipient@example.com" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "list_unsubscribe" | |
} | |
}, | |
"description": "User clicked the 'unsubscribe' button on an email client.", | |
"display_name": "List Unsubscribe" | |
}, | |
"link_unsubscribe": { | |
"event": { | |
"ab_test_id": { | |
"description": "A/B test of which this event was a part.", | |
"sampleValue": "password-reset" | |
}, | |
"ab_test_version": { | |
"description": "A/B test version that was used for this event.", | |
"sampleValue": "1" | |
}, | |
"amp_enabled": { | |
"description": "Indicates whether or not amp format was enabled", | |
"sampleValue": true | |
}, | |
"campaign_id": { | |
"description": "Campaign of which this message was a part", | |
"sampleValue": "Example Campaign Name" | |
}, | |
"click_tracking": { | |
"description": "Indicates whether or not click tracking was enabled", | |
"sampleValue": true | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"friendly_from": { | |
"description": "Friendly sender or 'From' header in the original email", | |
"sampleValue": "sender@example.com" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"initial_pixel": { | |
"description": "Indicates whether or not initial open pixel tracking was enabled", | |
"sampleValue": true | |
}, | |
"ip_address": { | |
"description": "IP address of the host to which SparkPost delivered this message; in engagement events, the IP address of the host where the HTTP request originated", | |
"sampleValue": "18.236.253.72" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"mailbox_provider": { | |
"description": "Mailbox Provider of the recipient", | |
"sampleValue": "Gsuite" | |
}, | |
"mailbox_provider_region": { | |
"description": "Region of the Mailbox Provider", | |
"sampleValue": "Europe - UK" | |
}, | |
"mailfrom": { | |
"description": "Envelope mailfrom of the original email", | |
"sampleValue": "recipient@example.com" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"open_tracking": { | |
"description": "Indicates whether or not open tracking was enabled", | |
"sampleValue": true | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_meta": { | |
"description": "Metadata describing the message recipient", | |
"sampleValue": { | |
"customKey": "customValue" | |
} | |
}, | |
"rcpt_tags": { | |
"description": "Tags applied to the message which generated this event", | |
"sampleValue": [ | |
"male", | |
"US" | |
] | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"rcpt_type": { | |
"description": "Indicates that a recipient address appeared in the Cc or Bcc header or the archive JSON array", | |
"sampleValue": "cc" | |
}, | |
"recipient_domain": { | |
"description": "Domain part of the recipient address used on this message's SMTP envelope", | |
"sampleValue": "example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"scheduled_time": { | |
"description": "Time at which the email was scheduled to be sent", | |
"sampleValue": "1588348800" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"subject": { | |
"description": "Subject line from the email header", | |
"sampleValue": "Summer deals are here!" | |
}, | |
"target_link_name": { | |
"description": "Name of the link for which a click event was generated", | |
"sampleValue": "Example Link Name" | |
}, | |
"target_link_url": { | |
"description": "URL of the link for which a click event was generated", | |
"sampleValue": "http://example.com" | |
}, | |
"template_id": { | |
"description": "Slug of the template used to construct this message", | |
"sampleValue": "templ-1234" | |
}, | |
"template_version": { | |
"description": "Version of the template used to construct this message", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"transactional": { | |
"description": "Indicates if the transmission was marked as transactional", | |
"sampleValue": "1" | |
}, | |
"transmission_id": { | |
"description": "Transmission which originated this message", | |
"sampleValue": "65832150921904138" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "link_unsubscribe" | |
}, | |
"user_agent": { | |
"description": "Value of the browser's User-Agent header", | |
"sampleValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36" | |
} | |
}, | |
"description": "User clicked a hyperlink in a received email.", | |
"display_name": "Link Unsubscribe" | |
} | |
}, | |
"description": "Unsubscribe events provide insight into the action the user performed to become unsubscribed.", | |
"display_name": "Unsubscribe Events" | |
}, | |
"relay_event": { | |
"events": { | |
"relay_injection": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"msg_size": { | |
"description": "Message's size in bytes", | |
"sampleValue": "1337" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "relay_injection" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"origination": { | |
"description": "Source of the event", | |
"sampleValue": "inbound" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"relay_id": { | |
"description": "Unique identifier of the Relay Webhook associated with this message (uuid)", | |
"sampleValue": "123-456-789" | |
} | |
}, | |
"description": "Relayed message is received by or injected into SparkPost.", | |
"display_name": "Relay Injection" | |
}, | |
"relay_rejection": { | |
"event": { | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"remote_addr": { | |
"description": "IP address of the host from which SparkPost received this message", | |
"sampleValue": "18.236.253.72" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"origination": { | |
"description": "Source of the event", | |
"sampleValue": "inbound" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "relay_rejection" | |
}, | |
"bounce_class": { | |
"description": "Classification code for a given message (see [Bounce Classification Codes](https://support.sparkpost.com/customer/portal/articles/1929896))", | |
"sampleValue": "25" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"relay_id": { | |
"description": "Unique identifier of the Relay Webhook associated with this message (uuid)", | |
"sampleValue": "123-456-789" | |
} | |
}, | |
"description": "SparkPost rejected a relayed message or failed to generate a relayed message.", | |
"display_name": "Relay Rejection" | |
}, | |
"relay_delivery": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "relay_delivery" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"origination": { | |
"description": "Source of the event", | |
"sampleValue": "inbound" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"relay_id": { | |
"description": "Unique identifier of the Relay Webhook associated with this message (uuid)", | |
"sampleValue": "123-456-789" | |
} | |
}, | |
"description": "Remote HTTP Endpoint acknowledged receipt of a relayed message.", | |
"display_name": "Relay Delivery" | |
}, | |
"relay_tempfail": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "relay_tempfail" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"origination": { | |
"description": "Source of the event", | |
"sampleValue": "inbound" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"relay_id": { | |
"description": "Unique identifier of the Relay Webhook associated with this message (uuid)", | |
"sampleValue": "123-456-789" | |
} | |
}, | |
"description": "Remote HTTP Endpoint has failed to accept a relayed message.", | |
"display_name": "Relay Temporary Failure" | |
}, | |
"relay_permfail": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "92356927693813856" | |
}, | |
"routing_domain": { | |
"description": "Domain receiving this message", | |
"sampleValue": "example.com" | |
}, | |
"rcpt_to": { | |
"description": "Lowercase version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"rcpt_hash": { | |
"description": "Hashed version of recipient address used on this message's SMTP envelope", | |
"sampleValue": "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed" | |
}, | |
"raw_rcpt_to": { | |
"description": "Actual recipient address used on this message's SMTP envelope", | |
"sampleValue": "recipient@example.com" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "relay_permfail" | |
}, | |
"message_id": { | |
"description": "SparkPost-cluster-wide unique identifier for this message", | |
"sampleValue": "000443ee14578172be22" | |
}, | |
"msg_from": { | |
"description": "Sender address used on this message's SMTP envelope", | |
"sampleValue": "sender@example.com" | |
}, | |
"recv_method": { | |
"description": "Protocol by which SparkPost received this message", | |
"sampleValue": "esmtp" | |
}, | |
"ip_pool": { | |
"description": "IP pool through which this message was sent", | |
"sampleValue": "example-ip-pool" | |
}, | |
"queue_time": { | |
"description": "Delay, expressed in milliseconds, between this message's injection into SparkPost and its delivery to the receiving domain; that is, the length of time this message spent in the outgoing queue", | |
"sampleValue": "12" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"num_retries": { | |
"description": "Number of failed attempts before this message was successfully delivered; when the first attempt succeeds, zero", | |
"sampleValue": "2" | |
}, | |
"delv_method": { | |
"description": "Protocol by which SparkPost delivered this message", | |
"sampleValue": "esmtp" | |
}, | |
"origination": { | |
"description": "Source of the event", | |
"sampleValue": "inbound" | |
}, | |
"outbound_tls": { | |
"description": "Whether a message was sent using TLS or not. Specifies if a message wasn't sent with TLS either because no TLS was offered or TLS negotiation failed. 1 means TLS was used, 0 means TLS was not offered, -1 means TLS negotiation failed", | |
"sampleValue": "-1" | |
}, | |
"raw_reason": { | |
"description": "Unmodified, exact response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (17.99.99.99) is in black list" | |
}, | |
"reason": { | |
"description": "Canonicalized text of the response returned by the remote server due to a failed delivery attempt", | |
"sampleValue": "MAIL REFUSED - IP (a.b.c.d) is in black list" | |
}, | |
"sending_ip": { | |
"description": "IP address through which this message was sent", | |
"sampleValue": "18.236.253.72" | |
}, | |
"error_code": { | |
"description": "Error code by which the remote server described a failed delivery attempt", | |
"sampleValue": "554" | |
}, | |
"injection_time": { | |
"description": "Time at which this message was injected into SparkPost", | |
"sampleValue": "2016-04-18T14:25:07.000Z" | |
}, | |
"relay_id": { | |
"description": "Unique identifier of the Relay Webhook associated with this message (uuid)", | |
"sampleValue": "123-456-789" | |
} | |
}, | |
"description": "Relayed message has reached the maximum retry threshold and will be removed from the system.", | |
"display_name": "Relay Permanent Failure" | |
} | |
}, | |
"description": "Relay events describe the life cycle of an inbound message including injection, delivery, and disposition.", | |
"display_name": "Relay Events" | |
}, | |
"ab_test_event": { | |
"events": { | |
"ab_test_completed": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "0e5cf1fc-cb36-4c39-b695-3651b6ea6563" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "ab_test_completed" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"ab_test": { | |
"description": "Metadata describing an A/B test", | |
"sampleValue": { | |
"id": "password-reset", | |
"name": "Password Reset", | |
"version": 1, | |
"test_mode": "bayesian", | |
"engagement_metric": "count_unique_clicked", | |
"default_template": { | |
"template_id": "templ-1234", | |
"count_unique_clicked": 10, | |
"count_accepted": 50, | |
"engagement_rate": 0.2 | |
}, | |
"variants": [ | |
{ | |
"template_id": "templ-5678", | |
"count_unique_clicked": 10, | |
"count_accepted": 50, | |
"engagement_rate": 0.2 | |
} | |
], | |
"winning_template_id": "templ-1234" | |
} | |
} | |
}, | |
"description": "Results of an A/B test", | |
"display_name": "A/B Test Completion" | |
}, | |
"ab_test_cancelled": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "0e5cf1fc-cb36-4c39-b695-3651b6ea6563" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "ab_test_cancelled" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"ab_test": { | |
"description": "Metadata describing an A/B test", | |
"sampleValue": { | |
"id": "password-reset", | |
"name": "Password Reset", | |
"version": 1, | |
"test_mode": "bayesian", | |
"engagement_metric": "count_unique_clicked", | |
"default_template": { | |
"template_id": "templ-1234", | |
"count_unique_clicked": 10, | |
"count_accepted": 50, | |
"engagement_rate": 0.2 | |
}, | |
"variants": [ | |
{ | |
"template_id": "templ-5678", | |
"count_unique_clicked": 10, | |
"count_accepted": 50, | |
"engagement_rate": 0.2 | |
} | |
] | |
} | |
} | |
}, | |
"description": "Details of a canceled A/B test", | |
"display_name": "A/B Test Cancellation" | |
} | |
}, | |
"description": "A/B test events describe the conclusion of an A/B test, such as completion or cancellation", | |
"display_name": "A/B Test Events" | |
}, | |
"ingest_event": { | |
"events": { | |
"success": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "0e5cf1fc-cb36-4c39-b695-3651b6ea6563" | |
}, | |
"batch_id": { | |
"description": "Universally unique identifier", | |
"sampleValue": "96500f4d-d4f4-4f1b-8080-02f4682184bb" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"expiration_timestamp": { | |
"description": "The time at which an ingest batch is no longer retrievable", | |
"sampleValue": "2019-06-16T19:02:09.373Z" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "success" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"number_succeeded": { | |
"description": "How many events succeeded processing", | |
"sampleValue": 500 | |
}, | |
"number_duplicates": { | |
"description": "How many events were already processed in a previous batch", | |
"sampleValue": 350 | |
} | |
}, | |
"description": "Details of an Ingest API processing success", | |
"display_name": "Ingest Event Success" | |
}, | |
"error": { | |
"event": { | |
"event_id": { | |
"description": "Unique event identifier", | |
"sampleValue": "0e5cf1fc-cb36-4c39-b695-3651b6ea6563" | |
}, | |
"batch_id": { | |
"description": "Universally unique identifier", | |
"sampleValue": "96500f4d-d4f4-4f1b-8080-02f4682184bb" | |
}, | |
"timestamp": { | |
"description": "Event date and time, in Unix timestamp format (integer seconds since 00:00:00 GMT 1970-01-01)", | |
"sampleValue": "1460989507" | |
}, | |
"expiration_timestamp": { | |
"description": "The time at which an ingest batch is no longer retrievable", | |
"sampleValue": "2019-06-16T19:02:09.373Z" | |
}, | |
"type": { | |
"description": "Type of event this record describes", | |
"sampleValue": "error" | |
}, | |
"error_type": { | |
"description": "Category of error that was encountered in processing", | |
"sampleValue": "validation" | |
}, | |
"customer_id": { | |
"description": "SparkPost-customer identifier through which this message was sent", | |
"sampleValue": "1" | |
}, | |
"subaccount_id": { | |
"description": "Unique subaccount identifier.", | |
"sampleValue": "101" | |
}, | |
"number_succeeded": { | |
"description": "How many events succeeded processing", | |
"sampleValue": 500 | |
}, | |
"number_duplicates": { | |
"description": "How many events were already processed in a previous batch", | |
"sampleValue": 350 | |
}, | |
"number_failed": { | |
"description": "How many events failed processing", | |
"sampleValue": 50 | |
}, | |
"retryable": { | |
"description": "Indicates if an error retryable", | |
"sampleValue": false | |
}, | |
"href": { | |
"description": "A reference to a failed batch", | |
"sampleValue": "https://api.sparkpost.com/api/v1/ingest/events/failures/fbd59e4c-1629-4736-803d-201ff9fa8dd6" | |
} | |
}, | |
"description": "Details of an Ingest API processing error", | |
"display_name": "Ingest Event Error" | |
} | |
}, | |
"description": "Ingest events describe the processing status of an upload to /api/v1/ingest/events", | |
"display_name": "Ingest Events" | |
} | |
} |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment