sesv2 function

Amazon Simple Email Service

Amazon Simple Email Service

Amazon SES API v2

Amazon SES is an Amazon Web Services service that you can use to send email messages to your customers.

If you're new to Amazon SES API v2, you might find it helpful to review the Amazon Simple Email Service Developer Guide. The Amazon SES Developer Guide provides information and code samples that demonstrate how to use Amazon SES API v2 features programmatically.

sesv2(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

  • config: Optional configuration of credentials, endpoint, and/or region.

    • credentials :

      • creds :

        • access_key_id : AWS access key ID
        • secret_access_key : AWS secret access key
        • session_token : AWS temporary session token
      • profile : The name of a profile to use. If not given, then the default profile is used.

      • anonymous : Set anonymous credentials.

    • endpoint : The complete URL to use for the constructed client.

    • region : The AWS Region used in instantiating the client.

    • close_connection : Immediately close all HTTP connections.

    • timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

    • s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

    • sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

  • credentials: Optional credentials shorthand for the config parameter

    • creds :

      • access_key_id : AWS access key ID
      • secret_access_key : AWS secret access key
      • session_token : AWS temporary session token
    • profile : The name of a profile to use. If not given, then the default profile is used.

    • anonymous : Set anonymous credentials.

  • endpoint: Optional shorthand for complete URL to use for the constructed client.

  • region: Optional shorthand for AWS Region used in instantiating the client.

Returns

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- sesv2(
  config = list(
    credentials = list(
 creds = list(
   access_key_id = "string",
   secret_access_key = "string",
   session_token = "string"
 ),
 profile = "string",
 anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
 access_key_id = "string",
 secret_access_key = "string",
 session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

batch_get_metric_dataRetrieves batches of metric data collected based on your sending activity
cancel_export_jobCancels an export job
create_configuration_setCreate a configuration set
create_configuration_set_event_destinationCreate an event destination
create_contactCreates a contact, which is an end-user who is receiving the email, and adds them to a contact list
create_contact_listCreates a contact list
create_custom_verification_email_templateCreates a new custom verification email template
create_dedicated_ip_poolCreate a new pool of dedicated IP addresses
create_deliverability_test_reportCreate a new predictive inbox placement test
create_email_identityStarts the process of verifying an email identity
create_email_identity_policyCreates the specified sending authorization policy for the given identity (an email address or a domain)
create_email_templateCreates an email template
create_export_jobCreates an export job for a data source and destination
create_import_jobCreates an import job for a data destination
create_multi_region_endpointCreates a multi-region endpoint (global-endpoint)
delete_configuration_setDelete an existing configuration set
delete_configuration_set_event_destinationDelete an event destination
delete_contactRemoves a contact from a contact list
delete_contact_listDeletes a contact list and all of the contacts on that list
delete_custom_verification_email_templateDeletes an existing custom verification email template
delete_dedicated_ip_poolDelete a dedicated IP pool
delete_email_identityDeletes an email identity
delete_email_identity_policyDeletes the specified sending authorization policy for the given identity (an email address or a domain)
delete_email_templateDeletes an email template
delete_multi_region_endpointDeletes a multi-region endpoint (global-endpoint)
delete_suppressed_destinationRemoves an email address from the suppression list for your account
get_accountObtain information about the email-sending status and capabilities of your Amazon SES account in the current Amazon Web Services Region
get_blacklist_reportsRetrieve a list of the blacklists that your dedicated IP addresses appear on
get_configuration_setGet information about an existing configuration set, including the dedicated IP pool that it's associated with, whether or not it's enabled for sending email, and more
get_configuration_set_event_destinationsRetrieve a list of event destinations that are associated with a configuration set
get_contactReturns a contact from a contact list
get_contact_listReturns contact list metadata
get_custom_verification_email_templateReturns the custom email verification template for the template name you specify
get_dedicated_ipGet information about a dedicated IP address, including the name of the dedicated IP pool that it's associated with, as well information about the automatic warm-up process for the address
get_dedicated_ip_poolRetrieve information about the dedicated pool
get_dedicated_ipsList the dedicated IP addresses that are associated with your Amazon Web Services account
get_deliverability_dashboard_optionsRetrieve information about the status of the Deliverability dashboard for your account
get_deliverability_test_reportRetrieve the results of a predictive inbox placement test
get_domain_deliverability_campaignRetrieve all the deliverability data for a specific campaign
get_domain_statistics_reportRetrieve inbox placement and engagement rates for the domains that you use to send email
get_email_identityProvides information about a specific identity, including the identity's verification status, sending authorization policies, its DKIM authentication status, and its custom Mail-From settings
get_email_identity_policiesReturns the requested sending authorization policies for the given identity (an email address or a domain)
get_email_templateDisplays the template object (which includes the subject line, HTML part and text part) for the template you specify
get_export_jobProvides information about an export job
get_import_jobProvides information about an import job
get_message_insightsProvides information about a specific message, including the from address, the subject, the recipient address, email tags, as well as events associated with the message
get_multi_region_endpointDisplays the multi-region endpoint (global-endpoint) configuration
get_suppressed_destinationRetrieves information about a specific email address that's on the suppression list for your account
list_configuration_setsList all of the configuration sets associated with your account in the current region
list_contact_listsLists all of the contact lists available
list_contactsLists the contacts present in a specific contact list
list_custom_verification_email_templatesLists the existing custom verification email templates for your account in the current Amazon Web Services Region
list_dedicated_ip_poolsList all of the dedicated IP pools that exist in your Amazon Web Services account in the current Region
list_deliverability_test_reportsShow a list of the predictive inbox placement tests that you've performed, regardless of their statuses
list_domain_deliverability_campaignsRetrieve deliverability data for all the campaigns that used a specific domain to send email during a specified time range
list_email_identitiesReturns a list of all of the email identities that are associated with your Amazon Web Services account
list_email_templatesLists the email templates present in your Amazon SES account in the current Amazon Web Services Region
list_export_jobsLists all of the export jobs
list_import_jobsLists all of the import jobs
list_multi_region_endpointsList the multi-region endpoints (global-endpoints)
list_recommendationsLists the recommendations present in your Amazon SES account in the current Amazon Web Services Region
list_suppressed_destinationsRetrieves a list of email addresses that are on the suppression list for your account
list_tags_for_resourceRetrieve a list of the tags (keys and values) that are associated with a specified resource
put_account_dedicated_ip_warmup_attributesEnable or disable the automatic warm-up feature for dedicated IP addresses
put_account_detailsUpdate your Amazon SES account details
put_account_sending_attributesEnable or disable the ability of your account to send email
put_account_suppression_attributesChange the settings for the account-level suppression list
put_account_vdm_attributesUpdate your Amazon SES account VDM attributes
put_configuration_set_archiving_optionsAssociate the configuration set with a MailManager archive
put_configuration_set_delivery_optionsAssociate a configuration set with a dedicated IP pool
put_configuration_set_reputation_optionsEnable or disable collection of reputation metrics for emails that you send using a particular configuration set in a specific Amazon Web Services Region
put_configuration_set_sending_optionsEnable or disable email sending for messages that use a particular configuration set in a specific Amazon Web Services Region
put_configuration_set_suppression_optionsSpecify the account suppression list preferences for a configuration set
put_configuration_set_tracking_optionsSpecify a custom domain to use for open and click tracking elements in email that you send
put_configuration_set_vdm_optionsSpecify VDM preferences for email that you send using the configuration set
put_dedicated_ip_in_poolMove a dedicated IP address to an existing dedicated IP pool
put_dedicated_ip_pool_scaling_attributesUsed to convert a dedicated IP pool to a different scaling mode
put_dedicated_ip_warmup_attributesPut dedicated ip warmup attributes
put_deliverability_dashboard_optionEnable or disable the Deliverability dashboard
put_email_identity_configuration_set_attributesUsed to associate a configuration set with an email identity
put_email_identity_dkim_attributesUsed to enable or disable DKIM authentication for an email identity
put_email_identity_dkim_signing_attributesUsed to configure or change the DKIM authentication settings for an email domain identity
put_email_identity_feedback_attributesUsed to enable or disable feedback forwarding for an identity
put_email_identity_mail_from_attributesUsed to enable or disable the custom Mail-From domain configuration for an email identity
put_suppressed_destinationAdds an email address to the suppression list for your account
send_bulk_emailComposes an email message to multiple destinations
send_custom_verification_emailAdds an email address to the list of identities for your Amazon SES account in the current Amazon Web Services Region and attempts to verify it
send_emailSends an email message
tag_resourceAdd one or more tags (keys and values) to a specified resource
test_render_email_templateCreates a preview of the MIME content of an email when provided with a template and a set of replacement data
untag_resourceRemove one or more tags (keys and values) from a specified resource
update_configuration_set_event_destinationUpdate the configuration of an event destination for a configuration set
update_contactUpdates a contact's preferences for a list
update_contact_listUpdates contact list metadata
update_custom_verification_email_templateUpdates an existing custom verification email template
update_email_identity_policyUpdates the specified sending authorization policy for the given identity (an email address or a domain)
update_email_templateUpdates an email template

Examples

## Not run: svc <- sesv2() svc$batch_get_metric_data( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17