SendGrid Connector Objects (NMC Schema)

NameDescription
AlertsCreate, update, delete, and query Alerts in SendGrid.
ApiKeysQuery, Create, Update and Delete the available ApiKeys in SendGrid.
AutomationStatsGet All Automation Stats
BlocksQuery and Delete the available Blocks in SendGrid.
BouncesQuery and Delete the available Bounces in SendGrid.
CancelScheduledSendsUpdate, delete, and query Cancel Scheduled Sends in SendGrid.
CategoriesQuery the available Categories in SendGrid.
CategoryStatsQuery the available Category Stats in SendGrid.
DesignsList Designs
DynamicTemplatesQuery Teammates in SendGrid.
GlobalStatsQuery the available Global Stats in SendGrid.
GlobalUnsubscribesQuery Global Unsubscribes in SendGrid.
GroupSuppressionsQuery group suppressions in SendGrid.
InvalidEmailsQuery and Delete invalid emails in SendGrid.
IPAccessManagementQuery Global Unsubscribes in SendGrid.
MailSettingsQuery all the mail settings in SendGrid.
MessageEventsList of events related to email message in SendGrid.
MessagesQuery Email Activities in SendGrid.
NMCContactsQuery New Marketing Campaign Contacts in SendGrid.
NMCCustomFieldsCreate, delete, and query New Marketing Campaign Custom Fields in SendGrid.
NMCListsCreate, update, delete, and query the available New Marketing Campaign Lists in SendGrid.
NMCReservedFieldsQuery the available New Marketing Campaign Reserved Fields in SendGrid.
NMCSegmentsCreate, update, delete, and query New Marketing Campaign Segments in SendGrid.
NMCSendersCreate, update, delete, and query New Marketing Campaign Senders in SendGrid.
NMCSingleSendsCreate, update, delete, and query the available New Marketing Campaign Single Sends in SendGrid.
PartnerSettingsQuery all the partner settings in SendGrid.
SingleSendClickTrackingStatsGet Single Send Click Tracking Stats by ID
SingleSendsStatsGet All Single Sends Stats
SpamQuery and delete Spam reports in SendGrid.
StatsByBrowserQuery Browser Statistics in SendGrid.
StatsByClientQuery Client Statistics in SendGrid.
StatsByDeviceQuery Device Statistics in SendGrid.
StatsByLocationQuery Location Statistics in SendGrid.
StatsByMailboxProviderQuery Mailbox Provider Statistics in SendGrid.
SubusersQuery all the subusers in sendgrid.
SubuserStatsQuery Subuser Statistics in SendGrid.
TeammatesQuery Teammates in SendGrid.
TemplatesRetrieve paged transactional templates
UnsubscribeGroupsCreate, update, delete, and query Unsubscribe Groups in SendGrid.
UsersQuery the available Users in SendGrid.
NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]IntegerFalseNoThe ID of the alert.
CreatedAtDatetimeTrueNoDate when the alert was created.
UpdatedAtDatetimeTrueNoDate when the alert was updated.
EmailToStringFalseNoThe email address that the alert will be sent to.
PercentageIntegerFalseNoThe email address that the alert will be sent to.
TypeStringFalseNoThe type of alert. Allowed values (usage_limit, stats_notification).
FrequencyStringFalseNoIf the alert is of type stats_notification, this indicates how frequently the stats notifications will be sent.(daily, weekly, monthly).
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ApiKeyId [KEY]StringFalseNoThe ID of your API Key.
NameStringFalseNoThe name of your API Key.
ScopesStringFalseNoThe permissions this API Key has access to. This is populated only when Id is specified.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
IdStringFalseNoThis is the ID of the Automation you are requesting stats for.
AggregationStringFalseNoThis describes the time unit to which the stat is rolled up. It is based on the aggregated_by parameter included in the request. It can be 'total' or the date (in YYYY-MM-DD format) the stats are for.
StepIdStringFalseNoThis is the ID of the step if the stats were requested to be grouped by step_id.
BounceDropsIntegerFalseNoBounceDrops
BouncesIntegerFalseNoBounces
ClicksIntegerFalseNoClicks
DeliveredIntegerFalseNoDelivered
InvalidEmailsIntegerFalseNoInvalidEmails
OpensIntegerFalseNoOpens
RequestsIntegerFalseNoRequests
SpamReportDropsIntegerFalseNoSpamReportDrops
SpamReportsIntegerFalseNoSpamReports
UniqueClicksIntegerFalseNoUniqueClicks
UniqueOpensIntegerFalseNoUniqueOpens
UnsubscribesIntegerFalseNoUnsubscribes

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CreatedAtDatetimeTrueNoThe time the block was created.
ReasonStringFalseNoThe reason for the block.
Email [KEY]StringFalseNoThe email that blocked.
StatusStringFalseNoThe enhanced SMTP block response.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CreatedAtDatetimeTrueNoThe time the bounce was created.
ReasonStringFalseNoThe reason for the bounce.
Email [KEY]StringFalseNoThe email that bounced.
StatusStringFalseNoThe enhanced SMTP bounce response.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
BatchId [KEY]StringFalseNoThe Id of the batch.
StatusStringFalseNoThe status of the scheduled send.Allowed Values: cancel, pause
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
NameStringTrueNoThe name of the categories.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TypeStringFalseNoThe type of the statistic.
NameStringFalseNoThe name of the category.
DateDateTrueNoThe time the global statistic was created.
BlocksIntegerFalseNoThe number of emails that were not allowed to be delivered by ISPs.
DropsIntegerFalseNoThe number of emails automatically dropped by SendGrid because they appear on one of the suppression lists.
BouncesIntegerFalseNoThe number of emails that bounced instead of being delivered.
ClicksIntegerFalseNoThe number of links clicked in your emails.
DeferredIntegerFalseNoThe number of emails temporarily refused by the receiving server.
DeliveredIntegerFalseNoThe number of emails confirmed delivered.
InvalidEmailsIntegerFalseNoThe number of emails with a malformed address or reported as invalid by the receiving server.
OpensIntegerFalseNoThe number of times your emails were opened by recipients.
ProcessedIntegerFalseNoThe number of emails pushed to SendGrid.
RequestsIntegerFalseNoThe number of emails you requested to send via SendGrid.
SpamReportDropsIntegerFalseNoThe number of emails automatically dropped because the emails were marked as spam by the recipients.
SpamReportsIntegerFalseNoThe number of emails marked as spam by recipients.
UniqueClicksIntegerFalseNoThe number of unique recipients who clicked links in your emails.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails.
UnsubscribeDropsIntegerFalseNoThe number of emails in this category dropped by SendGrid because the recipient unsubscribed from your emails.
UnsubscribesIntegerFalseNoThe number of recipients who unsubscribed from your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoID of the Design.
UpdatedAtStringFalseNoDatetime that Design was last updated.
CreatedAtStringFalseNoDatetime that Design was created.
ThumbnailURLStringFalseNoA Thumbnail preview of the template's html content.
NameStringFalseNoThe name of the new design.
EditorStringFalseNoThe editor used in the UI.
ItemUrlStringFalseNoThe URL of the Design Item.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe ID of the template.
NameStringFalseNoName of the template.
GenerationStringFalseNoGeneration of the template. (dynamic)
UpdatedAtDatetimeFalseNoThe last time the template was updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DateDateTrueNoThe time the global statistic was created.
BlocksIntegerFalseNoThe number of emails that were not allowed to be delivered by ISPs.
BounceDropsIntegerFalseNoThe number of emails automatically dropped by SendGrid because they appear on one of the suppression lists.
BouncesIntegerFalseNoThe number of emails that bounced instead of being delivered.
ClicksIntegerFalseNoThe number of links clicked in your emails.
DeferredIntegerFalseNoThe number of emails temporarily refused by the receiving server.
DeliveredIntegerFalseNoThe number of emails confirmed delivered.
InvalidEmailsIntegerFalseNoThe number of emails with a malformed address or reported as invalid by the receiving server.
OpensIntegerFalseNoThe number of times your emails were opened by recipients.
ProcessedIntegerFalseNoThe number of emails pushed to SendGrid.
RequestsIntegerFalseNoThe number of emails you requested to send via SendGrid.
SpamReportDropsIntegerFalseNoThe number of emails automatically dropped because the emails were marked as spam by the recipients.
SpamReportsIntegerFalseNoThe number of emails marked as spam by recipients.
UniqueClicksIntegerFalseNoThe number of unique recipients who clicked links in your emails.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails.
UnsubscribeDropsIntegerFalseNoThe number of emails globally dropped by SendGrid because the recipient unsubscribed from your emails.
UnsubscribesIntegerFalseNoThe number of recipients who unsubscribed from your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Email [KEY]StringFalseNoEmail of the unsubscriber.
CreatedAtDatetimeTrueNoThe time the unsubscriber was created.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
GroupId [KEY]IntegerFalseNoEmail of the unsubscriber.
EmailsStringFalseNoThe time the unsubscriber was created.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CreatedDatetimeTrueNoThe time the when the email address was added to the invalid emails list.
ReasonStringFalseNoA reason explaining why the email address was marked as invalid..
Email [KEY]StringFalseNoThe email address that was marked as invalid.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
IPStringFalseNoIP Address.
AllowedBooleanFalseNoIndicator if this IP is allowed for access.
AuthMethodStringFalseNoAuthentication method.
FirstAtTimestampFalseNoFirst time when IP has accessed the account.
LastAtTimestampFalseNoLast time when IP has accessed the account.
LocationStringFalseNoLocation of the IP.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TitleStringFalseNoThe title of the mail setting.
EnabledStringFalseNoIndicates if this mail setting is currently enabled.
NameStringFalseNoThe name of the mail setting.
DescriptionStringFalseNoA description of the mail setting.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
MessageIdStringTrueNoThe Id of the message.
EventNameStringTrueNoName of event.
ProcessedDatetimeTrueNoThe date when the event was processed.
ReasonStringTrueNoExplanation of what caused the message to be 'bounced', 'deferred', or 'blocked'.
AttemptNumIntegerTrueNoUsed with 'deferred' events to indicate the attempt number out of 10.
UrlStringTrueNoUsed with 'clicked' event to indicate which url the user clicked.
BounceTypeStringTrueNoUse to distinguish between types of bounces.
HttpUserAgentStringTrueNoClient recipient used to click or open message.
MXServerStringTrueNoThe MX server that received the email.
ApiKeyIdStringTrueNoId of the API Key.
AsmGroupIdStringTrueNoASM Group Id.
CategoriesStringTrueNoCategories users associated to the message.
UniqueArgsStringTrueNoJSON hash of key-value pairs associated with the message.
OriginatingIpStringTrueNoThis is the IP address of the person sending the message
OutboundIpStringTrueNoThis is the SendGrid dedicated IP address used to send the email
OutboundIpTypeStringTrueNoThe type of the outbound IP.
TeammateStringTrueNoUsername of the teammate.
TemplateIdStringTrueNoTemplate ID of the email.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the message.
StatusStringTrueNoStatus of the email.
SubjectStringTrueNoSubject of the email.
FromEmailStringTrueNoThe email of the sender.
ToEmailStringTrueNoThe email of the receiver.
ClicksCountIntegerTrueNoThe number of clicks.
OpensCountIntegerTrueNoThe number of times that the email was opened.
LastEventTimeDatetimeTrueNoThe datetime of the event.
ApiKeyIdStringTrueNoId of the API Key.
AsmGroupIdStringTrueNoASM Group Id.
MarketingCampaignIdStringTrueNoThe id of the marketing campaign.
MarketingCampaignNameStringTrueNoThe name of the marketing campaign.
MarketingCampaignSplitIdStringTrueNoSplit id of the campaign.
MarketingCampaignVersionStringTrueNoVersion of the campaign.
OriginatingIpStringTrueNoThis is the IP address of the person sending the message
OutboundIpStringTrueNoThis is the SendGrid dedicated IP address used to send the email
OutboundIpTypeStringTrueNoThe type of the outbound IP.
TeammateStringTrueNoUsername of the teammate.
TemplateIdStringTrueNoTemplate ID of the email.
EventsStringTrueNoList of events related to email message in SendGrid.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThis column is dynamic and maps to the corresponding field in the API.
AddressLine1StringTrueNoThis column is dynamic and maps to the corresponding field in the API.
AddressLine2StringTrueNoThis column is dynamic and maps to the corresponding field in the API.
CityStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
CountryStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
PostalCodeStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
StateProvinceRegionStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
LineStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
FacebookStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
PhoneNumberStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
UniqueNameStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
WhatsAppStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
EmailStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
FirstNameStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
LastNameStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
CreatedAtDatetimeTrueNoThis column is dynamic and maps to the corresponding field in the API.
UpdatedAtDatetimeTrueNoThis column is dynamic and maps to the corresponding field in the API.
ItemUrlStringTrueNoThis column is dynamic and maps to the corresponding field in the API.
SegmentIdStringFalseYesThis column is dynamic and maps to the corresponding field in the API.
ListIdStringFalseYesThis column is dynamic and maps to the corresponding field in the API.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the custom field.
NameStringFalseNoThe name of the custom field.
TypeStringFalseNoThe type of the custom field. Allowed values are number, text, or date.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the list.
NameStringFalseNoThe name of the list.
ContactCountIntegerTrueNoThe recipient count of the list.
ItemUrlStringTrueNoThe URL of the List Item.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
IdStringFalseNoThe Id of the reserved field.
NameStringFalseNoThe name of the reserved field.
TypeStringFalseNoThe type of the reserved field.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the segment.
NameStringFalseNoThe name of the segment.
ParentListIdStringFalseNoThe Id of the list associated with the segment.
ContactsCountIntegerTrueNoThe recipient count of the segment.
CreatedAtDatetimeTrueNoField name for the first condition.
SampleUpdatedAtDatetimeFalseNoField name for the first condition.
UpdatedAtDatetimeTrueNoField name for the first condition.
QueryDSLStringFalseNoField name for the first condition.
NextSampleUpdateDatetimeTrueNoThe last updated samples date.
ItemUrlStringTrueNoThe URL of the Segment item.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]IntegerTrueNoThe unique identifier of the sender identity.
NicknameStringFalseNoA nickname for the sender identity. Not used for sending..
FromEmailStringFalseNoThis is where the email will appear to originate from for your recipient.
FromNameStringFalseNoThis is the name appended to the from email field. IE - Your name or company name.
ReplytoEmailStringFalseNoThis is the email that your recipient will reply to.
ReplytoNameStringFalseNoThis is the name appended to the reply to email field. IE - Your name or company name.
AddressStringFalseNoThe physical address of the sender identity.
Address2StringFalseNoAdditional sender identity address information.
CityStringFalseNoThe city of the sender identity.
StateStringFalseNoThe state of the sender identity.
ZipStringFalseNoThe zipcode of the sender identity.
LockedStringFalseNoIndicator if the sender is locked.
VerifiedStatusStringFalseNoVerified status of the sender.
VerifiedReasonStringFalseNoVerified reason of the sender.
CountryStringFalseNoThe country of the sender identity.
CreatedAtDatetimeTrueNoThe end of the time range when the bounce was created.
UpdatedAtDatetimeTrueNoThe end of the time range when the bounce was created.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the single send.
NameStringFalseNoThe name of the single send.
CategoriesStringFalseNoThe name of the single send.
StatusStringFalseNoThe status of the single send.
CreatedAtStringTrueNoThe created timestamp of the single send.
UpdatedAtStringTrueNoThe updated timestamp of the single send.
IsABTestBooleanFalseNoIndicator showing if the single send is an AB Test.
SendAtDatetimeFalseNoThe ISO 8601 time at which to send the single send.
EmailConfigCustomUnsubscribeUrlStringFalseNoThe URL allowing recipients to unsubscribe.
EmailConfigEditorStringFalseNoThe editor, design or code, used to modify the Single Send's design in the Marketing Campaigns application user interface. This is populated only when Id is specified.
EmailConfigGeneratePlainContentBooleanFalseNoIf this property is set to true, plain_content is always generated from html_content. If it's set to false, plain_content is not altered. This is populated only when Id is specified.
EmailConfigHtmlContentStringFalseNoThe HTML content of the Single Send. This property is not used when a design_id value is set. This is populated only when Id is specified.
EmailConfigIpPoolStringFalseNoThe name of the IP Pool from which the Single Send emails are sent. This is populated only when Id is specified.
EmailConfigPlainContentStringFalseNoThe plain text content of the Single Send. This is populated only when Id is specified.
EmailConfigSenderIdIntegerFalseNoThe ID of the verified sender from whom the Single Send will be sent. This is populated only when Id is specified.
EmailConfigSubjectStringFalseNoThe subject line of the Single Send. This is populated only when Id is specified.
EmailConfigSuppressionGroupIdIntegerFalseNoThe ID of the Suppression Group to allow recipients to unsubscribe. This is populated only when Id is specified.
SendToListIdsStringFalseNoThe IDs of each contact list to which the Single Send will be sent. This is populated only when Id is specified.
SendToSegmentIdsStringFalseNoThe IDs of each segment to which the Single Send will be sent. This is populated only when Id is specified.
SendToAllBooleanFalseNoIf this property is set to true, the Single Send will be sent to all of your contacts. This is populated only when Id is specified.
ItemUrlStringTrueNoThe URL of the Single Send Item.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TitleStringFalseNoThe title of the partner.
EnabledStringFalseNoIndicates if this partner setting has been enabled.
NameStringFalseNoThe name of the partner setting.
DescriptionStringFalseNoA description of this partner setting.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SingleSendIdStringFalseNMCSingleSends.IdNoThe ID of Single Send for which you want to retrieve Click Tracking stats.
UrlStringFalseNoThis is the URL of the link clicked. If {{custom_fields}} are part of the URL, they will be included.
UrlLocationIntegerFalseNoThis is the location of the link clicked in each Single Send A/B variation, or in the Single Send itself if there are no variations. Links are numbered from the top down; the topmost link is index 0.
ABvariationStringFalseNoThis is the A/B variation of the Single Send stat returned. It is set to 'all' if the ab_variation query parameter was not set in the request and group_by doesn't contain ab_variation.
ABphaseStringFalseNoThis is the A/B phase of the Single Send stat returned. If the ab_phase query parameter was not provided, it will return 'all'.
ClicksIntegerFalseNoThe number of clicks on this particular link.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThis is the ID of the Single Send you require stats for.
ABvariationStringFalseNoThis is the A/B variation of the Single Send stat returned. If the group_by parameter doesn't include ab_variation in the request, then the value is 'all'.
ABphaseStringFalseNoThis is the A/B phase of the Single Send stat returned. If the group_by parameter doesn't include ab_phase in the request, then the value is 'all'.
AggregationStringFalseNoThis describes the time unit to which the stat is rolled up. It is based on the aggregated_by parameter included in the request. It can be 'total' or the date (in YYYY-MM-DD format) the stats are for.
BounceDropsIntegerFalseNoBounceDrops
BouncesIntegerFalseNoBounces
ClicksIntegerFalseNoClicks
DeliveredIntegerFalseNoDelivered
InvalidEmailsIntegerFalseNoInvalidEmails
OpensIntegerFalseNoOpens
RequestsIntegerFalseNoRequests
SpamReportDropsIntegerFalseNoSpamReportDrops
SpamReportsIntegerFalseNoSpamReports
UniqueClicksIntegerFalseNoUniqueClicks
UniqueOpensIntegerFalseNoUniqueOpens
UnsubscribesIntegerFalseNoUnsubscribes

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CreatedAtDatetimeTrueNoThe time when the spam report was made.
Email [KEY]StringFalseNoThe email address of the recipient who marked your message as spam.
IpStringFalseNoThe IP address that the message was sent on.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TypeStringFalseNoThe type of the statistic.
NameStringFalseNoThe name of the statistic.
DateDateTrueNoThe time the global statistic was created.
ClicksIntegerFalseNoThe number of links clicked in your emails.
UniqueClicksIntegerFalseNoThe number of unique recipients who clicked links in your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TypeStringFalseNoThe type of the statistic.
NameStringFalseNoThe name of the statistic.
DateDateTrueNoThe time the global statistic was created.
OpensIntegerFalseNoThe number of times your emails were opened by recipients.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TypeStringFalseNoThe type of the statistic.
NameStringFalseNoThe name of the statistic.
DateDateTrueNoThe time the global statistic was created.
OpensIntegerFalseNoThe number of times your emails were opened by recipients.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TypeStringFalseNoThe type of the statistic.
NameStringFalseNoThe name of the statistic.
DateDateTrueNoThe time the global statistic was created.
ClicksIntegerFalseNoThe number of links clicked in your emails.
OpensIntegerFalseNoThe number of times your emails were opened by recipients.
UniqueClicksIntegerFalseNoThe number of unique recipients who clicked links in your emails.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
TypeStringFalseNoThe type of the statistic.
NameStringFalseNoThe name of the statistic.
DateDateTrueNoThe time the global statistic was created.
BlocksIntegerFalseNoThe number of emails that were not allowed to be delivered by ISPs.
DropsIntegerFalseNoThe number of emails automatically dropped by SendGrid because they appear on one of the suppression lists.
BouncesIntegerFalseNoThe number of emails that bounced instead of being delivered.
ClicksIntegerFalseNoThe number of links clicked in your emails.
DeferredIntegerFalseNoThe number of emails temporarily refused by the receiving server.
DeliveredIntegerFalseNoThe number of emails confirmed delivered.
OpensIntegerFalseNoThe number of times your emails were opened by recipients.
ProcessedIntegerFalseNoThe number of emails pushed to SendGrid.
RequestsIntegerFalseNoThe number of emails you requested to send via SendGrid.
SpamReportsIntegerFalseNoThe number of emails marked as spam by recipients.
UniqueClicksIntegerFalseNoThe number of unique recipients who clicked links in your emails.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
IdIntegerTrueNoThe Id of the subuser.
EmailStringTrueNoThe email of the subuser.
UsernameStringTrueNoThe username of the subuser.
DisabledBooleanTrueNoIndicates whether the subuser is enabled or disabled.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DateDateTrueNoThe time the subuser statistic was created.
BlocksIntegerFalseNoThe number of emails that were not allowed to be delivered by ISPs.
DropsIntegerFalseNoThe number of emails automatically dropped because they appear on one of the suppression lists.
BouncesIntegerFalseNoThe number of emails that bounced instead of being delivered.
ClicksIntegerFalseNoThe number of links that were clicked in the emails from this subuser.
DeferredIntegerFalseNoThe number of emails temporarily refused by the receiving server.
DeliveredIntegerFalseNoThe number of emails from this subsuer that were confirmed delivered.
InvalidEmailsIntegerFalseNoThe number of emails with a malformed address or reported as invalid by the receiving server.
OpensIntegerFalseNoThe number of times emails from this subuser were opened by recipients.
ProcessedIntegerFalseNoThe number of emails pushed to SendGrid by this subuser.
RequestsIntegerFalseNoThe number of emails that you requested to send via SendGrid from this subuser.
SpamReportDropsIntegerFalseNoThe number of emails automatically dropped because the emails were marked as spam by the recipients.
SpamReportsIntegerFalseNoThe number of emails from this subuser that were marked as spam by recipients.
UniqueClicksIntegerFalseNoThe number of unique recipients who clicked on links in your emails from this subuser.
UniqueOpensIntegerFalseNoThe number of unique recipients who opened your emails from this subuser.
UnsubscribeDropsIntegerFalseNoThe number of emails from this subuser dropped by SendGrid because the recipients unsubscribed from your emails.
UnsubscribesIntegerFalseNoThe number of recipients who unsubscribed from your emails from this subuser.
SubuserNameStringFalseNoThe name of the statistic.
TypeStringFalseNoThe type of the statistic.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Username [KEY]StringFalseNoThe username of the teammate.
EmailStringFalseNoEmail of the teammate.
FirstNameStringFalseNoFirst name of the teammate.
LastNameStringFalseNoLast name of the teammate.
UserTypeStringFalseNoUser type of the teammate.
IsAdminBooleanFalseNoIndicator if the teammate is admin.
PhoneStringFalseNoPhone of the teammate.
WebsiteStringFalseNoWebsite of the teammate.
CompanyStringFalseNoCompany of the teammate.
AddressStringFalseNoAddress of the teammate.
Address2StringFalseNoAddress 2 of the teammate.
CityStringFalseNoCity of the teammate.
StateStringFalseNoState of the teammate.
CountryStringFalseNoCountry of the teammate.
ZipStringFalseNoZip of the teammate.
ScopesStringFalseNoScope of the permissions for the new teammate. Multiple values are allowed and should be split by a comma symbol. Possible values are: user.account.read,user.credits.read,user.email.create,user.email.read,user.email.update,user.email.delete,user.profile.create,user.profile.read,user.profile.update,user.profile.delete
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ID [KEY]StringFalseNoThe ID of the transactional template.
GenerationStringFalseNoDefines the generation of the template. By default, we will get data for both dynamic and legacy.
NameStringFalseNoThe name for the transactional template.
UpdatedAtStringFalseNoThe date and time that this transactional template version was updated.
VersionsStringFalseNoThe different versions of this transactional template.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]IntegerTrueNoId of the unsubscribe group.
NameStringFalseNoThe name of the unsubscribe group.
DescriptionStringFalseNoThe description of the unsubscribe group.
LastEmailSentAtDatetimeTrueNoThe last time an email was sent to the unsubscribe group.
IsDefaultBooleanFalseNoIf the unsubscribe group is the default group or not.
UnsubscribesIntegerTrueNoThe number of unsubscribes from this group.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the user.
AddressStringFalseNoThe address of the user.
Address2StringFalseNoThe secondary address field for the user.
CityStringFalseNoThe city of the user.
CompanyStringFalseNoThe company of the user.
CountryStringFalseNoThe country of the user.
FirstNameStringFalseNoThe first name of the user.
LastNameStringFalseNoThe last name of the user.
PhoneStringFalseNoThe phone number of the user.
StateStringFalseNoThe state the user is located in.
WebsiteStringFalseNoThe Web site URL of the user.
ZipStringFalseNoThe ZIP code of the user.
EmailStringTrueNoThe Email Address of the user.
AccountIdStringFalseYesThe ID of the account.
SubuserUsernameStringFalseYesThe username of the subuser.

Return to Top