Skip to main content

ISESV2UpdateEmailIdentityPolicyRequest

Interface in AWS.SESV2

Interface for UpdateEmailIdentityPolicy requests.

Ancestors

Properties

EmailIdentity

property EmailIdentity: string

The verified email address or domain to update the sending authorization policy for.

This identifies the specific email identity (either an email address or domain) whose sending authorization policy will be updated. The identity must be verified in your Amazon SES account and you must be the owner of the identity. This field is required and must be at least 1 character in length. Only verified identity owners can update sending authorization policies for their identities. Examples include individual email addresses like user@example.com or entire domains like example.com for broader authorization scope.

PolicyName

property PolicyName: string

The name of the sending authorization policy to update or create.

This identifies the specific policy within the email identity's authorization configuration. If a policy with this name already exists, it will be updated. If no policy exists with this name, a new policy will be created. This field is required and must be between 1 and 64 characters in length. The policy name can only include alphanumeric characters, dashes (-), and underscores (_) for consistent naming and URL compatibility. Choose descriptive policy names that indicate the purpose or authorized entity, such as "CrossAccountAccess" or "PartnerSendingRights" for better policy management.

Policy

property Policy: string

The JSON policy document defining the sending authorization permissions.

This contains the complete sending authorization policy in JSON format, defining which AWS accounts or services are authorized to send emails using your identity, under what conditions, and with what restrictions. The policy document must be valid JSON and cannot exceed 4 KB in size. It should follow AWS IAM policy syntax and include elements such as Version, Statement, Effect, Principal, Action, and optional conditions. This field is required and must be at least 1 character in length. The policy defines fine-grained permissions for authorized senders, enabling secure delegation of email sending privileges to trusted third parties. Sending authorization policies support conditions based on sender identity, email content, recipient addresses, and other contextual factors for comprehensive access control and security enforcement.