EmailSendDefinition

The EmailSendDefinition object contains the message information, sender profile, delivery profile, and audience information.

  • To create an EmailSendDefinition with a SendDefinitionList where the DataSourceTypeID=List and SendDefinitionListType=SourceList, you need the Email | Subscribers | List | SendEmailToList permission.
  • To create or update an EmailSendDefinition with a SendDefinitionList where the ID is the All Subs List, you need the Email | Subscribers | All Subscribers | SendEmailToList and View permissions.
  • To start or test an EmailSendDefinition using the perform method, you need the Email | Content | Email | Send or Test Send permissions.
NameData TypeDescription
Additionalxsd:stringThe ID for a send that customers use as a campaign ID. This property contains external campaign ID information or more metadata that appears in the tracking extract, and there is a personalization string for it. You can set this information at the time of the send or within an email send definition.
AutoBccEmailxsd:stringDefines blind carbon copy email address to which to send a message as part of an email send definition.
BccEmailxsd:stringIndicates email addresses to receive blind carbon copy of a message. The BccEmail property allows access to the BCC feature if enabled on the account. It does not error out if feature is not enabled. The API returns no tracking information for BCC emails. You must specify this property in an email send definition. You can’t specify this property at send time. However, you can create a profile attribute for this property and pass in a value at send time.
CategoryIDxsd:intSpecifies the identifier of the folder.
CCEmailxsd:stringCarbon copy email address. You must specify the CCEmail property in an email send definition, as you can’t specify this property at send time. You can create a profile attribute for this property and pass in a value at send time, however.
ClientClientIDSpecifies the account ownership and context of an object.
CorrelationIDxsd:stringIdentifies correlation of objects across several requests.
CreatedDatexsd:dateTimeRead-only date and time of the object's creation.
CustomerKeyxsd:stringUser-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object.
DeduplicateByEmailxsd:booleanIndicates whether a send definition de-duplicates multiple emails sent to the same email address. Set to true to ensure that only one message is sent to a single email address, if that email appears on several different lists or data extensions in a send definition.
DeliveryProfileDeliveryProfileIdentifies the delivery profile included in a send classification.
DeliveryScheduledTimexsd:dateTimeDefines scheduled data and time for a send related to an email send definition.
Descriptionxsd:stringDescribes and provides information regarding the object.
DomainTypeDeliveryProfileDomainTypeEnumDefines the type of domain associated with a delivery profile or send definition. Valid values include DefaultDomain or CustomDomain.
DynamicEmailSubjectxsd:stringContains content to be used in a dynamic subject line.
EmailEmailDefault email address for object. Indicates if subscriber information can be used for email sends.
EmailSubjectxsd:stringSubject for an email send. This property is required when updating a user-initiated send definition. If you don't pass the new subject to the email send definition, it retains the old subject for that definition. You must also specify the send classification to use as part of the send.
ExclusionFilterxsd:stringContains a string of AMPscript that can evaluate to true or false, used to exclude email addresses from a send definition. If you include an ExclusionFilter in a create call, you must also include the SendDefinitionList property. The ExclusionFilter property can cause performance issues with send time for large amounts of email addresses. Use the data filter function if you experience performance problems.
FooterContentAreaContentAreaDefines footer content area to use as part of a delivery profile or send definition.
FooterSalutationSourceSalutationSourceEnumDefines source of a footer salutation to use as part of a delivery profile or send definition. Valid values include:
  • Default
  • Content Library
  • None
FromAddressxsd:stringIndicates From address associated with a object. Deprecated for email send definitions and triggered send definitions.
FromNamexsd:stringSpecifies the default email message From Name. Deprecated for email send definitions and triggered send definitions.
HeaderContentAreaContentAreaDefines content area to be used in the header of a delivery profile or a send definition.
HeaderSalutationSourceSalutationSourceEnumDefines source of header salutation for a delivery profile or send definition. Valid values include:
  • Default
  • Content Library
  • None
IDxsd:intRead-only identifier for an object. Some objects use the ObjectID property as a unique ID.
InteractionObjectIDxsd:stringReturns associated ID for activities within the asynchronous process of the overall conversation or program.
IsMultipartxsd:booleanIndicates whether the email is sent with Multipart/MIME enabled.
IsSeedListSendxsd:booleanIndicates whether a email send includes the use of a seed list.
IsSendLoggingxsd:booleanIndicates whether send logging is enabled for the specified send definition
IsWrappedxsd:booleanIndicates whether an email send contains the links necessary to process tracking information for clicks.
Keywordxsd:stringReserved for future use.
MessageDeliveryTypeMessageDeliveryTypeEnumEnumerates the types of message delivery options available for email send definitions. Valid values include:
  • Standard - use as default unless your account is configured to handle burst sending
  • DelayedDeliveryByMTAQueue
ModifiedDateNullable`1Indicates the last time object information was modified.
Namexsd:stringName of the object or property.
ObjectIDxsd:stringSystem-controlled, read-only text string identifier for object.
ObjectStatexsd:stringReserved for future use.
OwnerOwnerDescribes account ownership of subscriber in an on-your-behalf account.
PartnerKeyxsd:stringUnique identifier provided by partner for an object. This property is accessible only via API.
PartnerPropertiesAPIProperty[]A collection of metadata supplied by the client and stored by the system. These properties are accessible only via API.
PreHeaderxsd:stringContains text used in preheader of email message on mobile devices.
PrivateDomainPrivateDomainDefines private domain to use as part of a delivery profile or send definition.
PrivateIPPrivateIPContains information on the private IP address associated with a delivery profile.
ReplyToAddressxsd:stringSpecifies the reply address used for any messages sent using this send definition.
ReplyToDisplayNamexsd:stringOptional value that specifies the display name for the email address contained in the ReplyToAddress property.
SeedListOccurancexsd:intProperty definition.
SendClassificationSendClassificationIndicates the send classification to use as part of a send definition. This field is required when updating a user-initiated send definition.
SendDefinitionListSendDefinitionList[]Indicates the subscriber list to use as part of an email send definition.
SenderProfileSenderProfileIdentifies the sender profile included in the send classification.
SendLimitxsd:intIndicates limit of messages to send as part of a send definition within a predefined send window.
SendWindowClosexsd:dateTimeDefines the end of a send window for a send definition.
SendWindowDeletexsd:booleanIndicates whether an existing send window for a send definition is deleted.
SendWindowOpenxsd:dateTimeDefines the beginning of a send window for a send definition.
SourceAddressTypeDeliveryProfileSourceAddressTypeEnumIndicates the source IP address type used with the delivery profile. Valid values include DefaultPrivateIPAddress and CustomPrivateIPAddress.
SuppressTrackingxsd:booleanIndicates whether the send definition suppresses tracking results for associated sends.
TestEmailAddrxsd:stringDefines an email address to which to send a test message as part of an email send definition.Use the Test action when sending a test email to an email send definition.
TimeZoneTimeZoneContains time zone information for an Account. For Create and Update calls, this property defines the time zone for an Account object. On a Retrieve call, TimeZone indicates which time zone is in effect for the Account object in question. Without a specific time zone, the Account defaults to Central Standard Time.
TrackingUsersTrackingUser[]Defines account users with access to tracking information for that send definition.
NameDescription
CreateCreates an individual object or a batch of objects.
DeleteDeletes an individual object or a batch of objects.
PerformManages asynchronous processes.
RetrieveRetrieves an individual object or a batch of objects.
UpdateUpdates an individual object or a batch of objects.