Skip to main content

ISESV2SendEmailRequest

Interface in AWS.SESV2

Interface for SendEmail requests.

Ancestors

Properties

ConfigurationSetName

property ConfigurationSetName: string

The name of the configuration set to use when sending the email.

The configuration set provides delivery options, event destinations, reputation tracking, and other sending policies that will be applied to this email. This field is optional. When not specified, the email will be sent using your account's default settings without any configuration set policies.

Content

property Content: ISESV2EmailContent

Type: ISESV2EmailContent

The email content including message body, subject, and format type.

This object contains the actual email content and can be one of three types: Simple (standard email with subject and body), Raw (MIME-formatted email with full control over headers), or Templated (personalized email using templates). This field is required and defines the structure and content of the email to be sent to recipients.

Destination

property Destination: ISESV2Destination

Type: ISESV2Destination

The recipients of the email message including To, Cc, and Bcc addresses.

This object specifies all recipient email addresses categorized by delivery type. You can send to multiple recipients across To, Cc (carbon copy), and Bcc (blind carbon copy) fields simultaneously. This field is optional. When not specified, recipient information must be provided in the email content (for Raw emails) or through other means.

EmailTags

property EmailTags: TList<ISESV2MessageTag>

Type: ISESV2MessageTag

Tags to apply to the email for tracking, categorization, and analytics purposes.

These name/value pair tags enable email sending event publishing and help organize and analyze email campaigns. Tags are useful for tracking email performance and categorizing messages by campaign, type, or other criteria. This field is optional but recommended for email tracking and analytics.

EndpointId

property EndpointId: string

The ID of the multi-region endpoint for global email delivery.

This optional parameter specifies a global endpoint that can route emails through multiple AWS regions for improved delivery reliability and performance. When not specified, the email is sent through the standard regional endpoint.

FeedbackForwardingEmailAddress

property FeedbackForwardingEmailAddress: string

The email address to receive bounce and complaint notifications.

When bounce or complaint events occur for this email, notification emails will be sent to this address for delivery issue tracking and sender reputation management. This field is optional. When not specified, notifications use the default feedback forwarding configuration for the sending identity.

FeedbackForwardingEmailAddressIdentityArn

property FeedbackForwardingEmailAddressIdentityArn: TARN

The ARN of the identity authorized for the feedback forwarding email address.

This parameter is used only for sending authorization scenarios where you need to use a feedback forwarding address that belongs to a different AWS account or requires explicit authorization. The ARN must be associated with a sending authorization policy that permits the use of the specified feedback forwarding email address. This field must be at least 1 character in length when specified.

FromEmailAddress

property FromEmailAddress: string

The email address to use as the From address for the email.

This address appears in the From header and must be a verified identity in your Amazon SES account. Recipients will see this as the sender of the email. This field is optional. When not specified, the From address must be defined in the email content headers (for Raw emails) or template configuration.

FromEmailAddressIdentityArn

property FromEmailAddressIdentityArn: TARN

The ARN of the identity authorized for the From email address.

This parameter is used only for sending authorization scenarios where you need to use a From address that belongs to a different AWS account or requires explicit authorization through a sending authorization policy. For Raw emails, this ARN value overrides the X-SES-SOURCE-ARN and X-SES-FROM-ARN headers specified in the raw email message content. The field must be at least 1 character in length when specified.

ListManagementOptions

property ListManagementOptions: ISESV2ListManagementOptions

Type: ISESV2ListManagementOptions

List management options for unsubscribe functionality.

This object specifies which contact list and topic the email belongs to, enabling recipients to unsubscribe from specific topics or entire lists through automated unsubscribe handling. This field is optional but recommended for marketing emails and newsletters to provide compliant unsubscribe functionality.

ReplyToAddresses

property ReplyToAddresses: TList<string>

The Reply-To email addresses for the message.

When recipients reply to this email, their replies will be sent to these addresses instead of the From address. Multiple Reply-To addresses can be specified to distribute responses. This field is optional. When not specified, replies will be sent to the From address by default.

TenantName

property TenantName: string

The name of the tenant through which this email will be sent.

All referenced resources including identities, configuration sets, and templates must be associated with this tenant for the email sending operation to succeed. This field is optional and must be at least 1 character in length when specified. Tenant-based sending enables multi-tenancy and resource isolation within Amazon SES.

Methods

AddEmailTag

procedure AddEmailTag(const AMessageTag: ISESV2MessageTag); overload;

ISESV2MessageTag

Add an email tag to EmailTags.

Parameters

NameDescription
AMessageTagSpecifies a message tag to add to EmailTags.

procedure AddEmailTag(const AName, AValue: string); overload;

Add an email tag to EmailTags.

Parameters

NameDescription
ANameSpecifies the name of a message tag to add.
AValueSpecifies the value of a message tag to add.

AddReplyToAddress

procedure AddReplyToAddress(const AEmailAddress: string);

Add an email address to ReplyToAddresses.

Parameters

NameDescription
AEmailAddressSpecifies an email address to add to ReplyToAddresses.