Amazon SES Email API

The Email API from Amazon SES — 60 operation(s) for email.

Operations 86

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v2/email/metrics/batch Pull batches of sending metrics · Batch get metric data #
Ask an LLM
“Can I fetch several sending metric queries, like sends and bounces, in one request?”
“How many metric queries can a single batch request include before it gets throttled?”
Tell an agent
Run these sending metric queries in one batch: {queries}.
Fetch batched delivery and complaint metrics for my sending activity using {queries}.
POST /v2/email/configuration-sets Create a configuration set · Create configuration set #
Ask an LLM
“How do I create a new group of sending rules to apply to the emails I send?”
“Can I set tracking, reputation and suppression options when I first create a configuration set?”
Tell an agent
Create a new configuration set called {name}.
Create configuration set {name} with these tags: {tags}.
GET /v2/email/configuration-sets List configuration sets in the region · List configuration sets #
Ask an LLM
“Which configuration sets exist on my Amazon SES account in this region?”
“Can I page through all my email configuration sets a few at a time?”
Tell an agent
List all of my configuration sets in the current region.
Show the next {page_size} configuration sets after token {next_token}.
POST /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations Add an event destination to a configuration set · Create configuration set event destination #
Ask an LLM
“How do I start publishing delivery, bounce and complaint events from a configuration set somewhere new?”
“Can I send open and click events for a configuration set to a new destination?”
Tell an agent
Add a new event destination named {destination_name} to configuration set {config_set} using {destination}.
Create event destination {destination_name} on {config_set}.
GET /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations List a configuration set's event destinations · Get configuration set event destinations #
Ask an LLM
“Where are the bounce, open and click events for a configuration set being sent?”
“What event destinations are attached to one of my configuration sets?”
Tell an agent
Show every event destination attached to configuration set {config_set}.
List where send, delivery and complaint events go for {config_set}.
POST /v2/email/contact-lists/{ContactListName}/contacts Add a contact to a contact list · Create contact #
Ask an LLM
“How do I add a new recipient's email address to one of my contact lists?”
“Can I set a new contact's topic preferences and attributes when adding them to a list?”
Tell an agent
Add {email} as a new contact on list {list}.
Add {email} to {list} with topic preferences {preferences}.
GET /v2/email/contact-lists/{ContactListName}/contacts List the contacts on a contact list · List contacts #
Ask an LLM
“Who is subscribed to one of my contact lists?”
“Can I filter the contacts on a list, for example by topic subscription?”
Tell an agent
List all contacts on contact list {list}.
Show contacts on {list} that match {filter}.
POST /v2/email/contact-lists Create a contact list · Create contact list #
Ask an LLM
“How do I set up a new contact list with subscription topics?”
“Can a new contact list have a description and tags from the start?”
Tell an agent
Create a contact list named {list_name}.
Create contact list {list_name} with topics {topics} and description {description}.
GET /v2/email/contact-lists List all contact lists · List contact lists #
Ask an LLM
“What contact lists do I have set up for subscription management?”
“Which mailing lists exist on my account right now?”
Tell an agent
List all of my contact lists.
Show up to {page_size} contact lists.
POST /v2/email/custom-verification-email-templates Create a custom verification email template · Create custom verification email template #
Ask an LLM
“Can I brand the email people get when I verify their address, with my own subject and redirect pages?”
“What do I need to supply to build a new custom verification email template?”
Tell an agent
Create custom verification template {template} sent from {from} with subject {subject}.
Create verification template {template} that redirects to {success_url} on success and {failure_url} on failure.
GET /v2/email/custom-verification-email-templates List custom verification email templates · List custom verification email templates #
Ask an LLM
“Which custom verification email templates have I created in this region?”
“What branded verification emails are available to send to new addresses?”
Tell an agent
List my custom verification email templates.
Show {page_size} custom verification templates starting at token {next_token}.
POST /v2/email/dedicated-ip-pools Create a dedicated IP pool · Create dedicated ip pool #
Ask an LLM
“How do I create a new pool to group my dedicated sending IP addresses?”
“Can a new dedicated IP pool be managed with automatic scaling instead of standard mode?”
Tell an agent
Create a dedicated IP pool named {pool}.
Create dedicated IP pool {pool} with scaling mode {mode}.
GET /v2/email/dedicated-ip-pools List dedicated IP pools · List dedicated ip pools #
Ask an LLM
“What dedicated IP pools do I have in this region?”
“Which pools have I grouped my dedicated sending IPs into?”
Tell an agent
List all my dedicated IP pools.
Show the next {page_size} dedicated IP pools.
POST /v2/email/deliverability-dashboard/test Run a predictive inbox placement test · Create deliverability test report #
Ask an LLM
“Can I test whether a message will land in the inbox or spam folder at major mailbox providers before sending it?”
“How would I start a new predictive inbox placement test?”
Tell an agent
Start an inbox placement test sending {content} from {from}.
Run a predictive inbox placement test named {report} from {from} with content {content}.
POST /v2/email/identities Start verifying an email address or domain · Create email identity #
Ask an LLM
“How do I verify a new domain so I can send email from it?”
“Can I bring my own DKIM key when I add a new sending domain?”
Tell an agent
Start verifying {identity} as a sending identity.
Add domain {identity} with DKIM signing attributes {dkim} and default configuration set {config_set}.
GET /v2/email/identities List verified email addresses and domains · List email identities #
Ask an LLM
“Which email addresses and domains are registered as sending identities on my account?”
“Can I see every identity I've started verifying, whether or not it succeeded?”
Tell an agent
List all of my email identities.
Show {page_size} email identities starting from token {next_token}.
POST /v2/email/identities/{EmailIdentity}/policies/{PolicyName} Add a sending authorization policy to an identity · Create email identity policy #
Ask an LLM
“How do I let another account send email on behalf of my verified domain?”
“Who is allowed to attach a new sending authorization policy to an identity?”
Tell an agent
Attach a new sending authorization policy {policy_name} to {identity} with document {policy}.
Create policy {policy_name} on identity {identity} granting delegated sending.
DELETE /v2/email/identities/{EmailIdentity}/policies/{PolicyName} Remove a sending authorization policy · Delete email identity policy #
Ask an LLM
“Can I revoke someone's permission to send from my domain by removing its policy?”
“Does deleting a sending authorization policy fail if the policy is already gone?”
Tell an agent destructive · confirm first
Delete sending authorization policy {policy_name} from {identity}.
Remove the {policy_name} policy on identity {identity}.
PUT /v2/email/identities/{EmailIdentity}/policies/{PolicyName} Update an identity's sending authorization policy · Update email identity policy #
Ask an LLM
“Can I change an existing sending authorization policy that lets others send from my domain?”
“What happens if I update a sending authorization policy that doesn't exist?”
Tell an agent
Replace the existing policy {policy_name} on {identity} with {policy}.
Edit sending authorization policy {policy_name} for identity {identity}.
POST /v2/email/templates Create an email template · Create email template #
Ask an LLM
“How do I save a reusable template for personalized emails?”
“Can a new template include a subject line, HTML part and text part?”
Tell an agent
Create an email template named {template} with content {content}.
Save a new personalized email template {template}.
GET /v2/email/templates List email templates · List email templates #
Ask an LLM
“Which email templates are saved in my Amazon SES account in this region?”
“Is there a rate limit on listing my email templates?”
Tell an agent
List all of my email templates.
Show {page_size} email templates after token {next_token}.
POST /v2/email/import-jobs Start a bulk import job · Create import job #
Ask an LLM
“How do I bulk import email addresses from a file into a contact list or suppression list?”
“What data source does a new import job need?”
Tell an agent
Start an import job from {source} into {destination}.
Import the addresses in {source} into destination {destination}.
GET /v2/email/import-jobs List contact import jobs · List import jobs #
Ask an LLM
“What bulk import jobs have I run into my suppression list or contact lists?”
“Can I see only import jobs of one destination type?”
Tell an agent
List all my import jobs.
Show import jobs whose destination type is {type}.
DELETE /v2/email/configuration-sets/{ConfigurationSetName} Delete a configuration set · Delete configuration set #
Ask an LLM
“How do I get rid of a configuration set I no longer apply to my emails?”
“Can I remove an entire configuration set along with its rules?”
Tell an agent destructive · confirm first
Delete configuration set {config_set}.
Remove the {config_set} configuration set from my account.
GET /v2/email/configuration-sets/{ConfigurationSetName} Get a configuration set's details · Get configuration set #
Ask an LLM
“Which dedicated IP pool and reputation settings does one configuration set use?”
“Is sending currently enabled for a particular configuration set?”
Tell an agent
Show the details of configuration set {config_set}.
Tell me whether {config_set} has sending and reputation tracking enabled.
DELETE /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName} Delete an event destination · Delete configuration set event destination #
Ask an LLM
“How do I stop publishing email events to one destination on a configuration set?”
“Can I remove a single event destination without deleting the whole configuration set?”
Tell an agent destructive · confirm first
Delete event destination {destination_name} from configuration set {config_set}.
Stop sending events for {config_set} to {destination_name}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName} Change an event destination's settings · Update configuration set event destination #
Ask an LLM
“Can I change which events an existing event destination receives?”
“What would I call to reconfigure an event destination that's already on a configuration set?”
Tell an agent
Update event destination {destination_name} on {config_set} to {destination}.
Reconfigure the existing {destination_name} destination in configuration set {config_set}.
DELETE /v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress} Remove a contact from a list · Delete contact #
Ask an LLM
“How do I take one person off a contact list entirely?”
“Can I delete a single contact without affecting the rest of the list?”
Tell an agent destructive · confirm first
Remove {email} from contact list {list}.
Delete the contact {email} in {list}.
GET /v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress} Look up one contact on a list · Get contact #
Ask an LLM
“What topic preferences does a specific subscriber have on one of my lists?”
“Has a particular email address unsubscribed from everything on a contact list?”
Tell an agent
Show contact {email} on list {list}.
Get the subscription preferences for {email} in {list}.
PUT /v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress} Update a contact's list preferences · Update contact #
Ask an LLM
“Can I change just one topic preference for an existing contact without resending all of them?”
“How do I mark an existing contact as unsubscribed from all topics?”
Tell an agent
Update {email} on list {list} with topic preferences {preferences}.
Set unsubscribe-all to {unsubscribe_all} for {email} on {list}.
DELETE /v2/email/contact-lists/{ContactListName} Delete a contact list and its contacts · Delete contact list #
Ask an LLM
“What happens to the contacts when I delete a whole contact list?”
“How do I remove a mailing list I no longer use?”
Tell an agent destructive · confirm first
Delete contact list {list} and everyone on it.
Remove the {list} list permanently.
GET /v2/email/contact-lists/{ContactListName} Get a contact list's metadata · Get contact list #
Ask an LLM
“What topics and description are defined on one of my contact lists?”
“Does fetching a contact list return its contacts or just its settings?”
Tell an agent
Show the topics and description of contact list {list}.
Get metadata for the {list} list.
PUT /v2/email/contact-lists/{ContactListName} Replace a contact list's topics and description · Update contact list #
Ask an LLM
“Can I add or rename subscription topics on an existing contact list?”
“Does updating a contact list replace its metadata completely?”
Tell an agent
Replace the topics on contact list {list} with {topics}.
Change the description of {list} to {description}.
DELETE /v2/email/custom-verification-email-templates/{TemplateName} Delete a custom verification email template · Delete custom verification email template #
Ask an LLM
“How do I remove a branded verification email template I no longer need?”
“Can I delete one custom verification template by name?”
Tell an agent destructive · confirm first
Delete custom verification template {template}.
Remove the {template} verification email template.
GET /v2/email/custom-verification-email-templates/{TemplateName} Get a custom verification email template · Get custom verification email template #
Ask an LLM
“What subject, sender and redirect URLs does one of my verification templates use?”
“Can I view the content of a specific custom verification email?”
Tell an agent
Show custom verification template {template}.
Get the content and redirect URLs of verification template {template}.
PUT /v2/email/custom-verification-email-templates/{TemplateName} Update a custom verification email template · Update custom verification email template #
Ask an LLM
“Can I change the redirect pages on a verification template I already created?”
“Which fields must I resend when editing an existing custom verification template?”
Tell an agent
Update verification template {template} to send from {from} with subject {subject} and content {content}.
Point existing verification template {template} at {success_url} for success and {failure_url} for failure.
DELETE /v2/email/dedicated-ip-pools/{PoolName} Delete a dedicated IP pool · Delete dedicated ip pool #
Ask an LLM
“How do I remove a dedicated IP pool I'm no longer sending from?”
“Can I delete a pool of dedicated IPs by its name?”
Tell an agent destructive · confirm first
Delete dedicated IP pool {pool}.
Remove the {pool} IP pool.
GET /v2/email/dedicated-ip-pools/{PoolName} Get a dedicated IP pool's details · Get dedicated ip pool #
Ask an LLM
“Is a particular dedicated IP pool using standard or managed scaling?”
“What can I find out about one dedicated IP pool?”
Tell an agent
Show details for dedicated IP pool {pool}.
Tell me the scaling mode of pool {pool}.
DELETE /v2/email/identities/{EmailIdentity} Delete an email address or domain identity · Delete email identity #
Ask an LLM
“How do I stop using a domain as a sending identity and remove it?”
“Can I delete a verified email address from my account?”
Tell an agent destructive · confirm first
Delete email identity {identity}.
Remove the sending domain {identity} from my account.
GET /v2/email/identities/{EmailIdentity} Get an identity's verification and DKIM status · Get email identity #
Ask an LLM
“Has my domain finished verification, and is DKIM set up correctly?”
“What Mail-From and feedback settings does one sending identity have?”
Tell an agent
Show the verification status and DKIM details for {identity}.
Check whether identity {identity} is verified.
DELETE /v2/email/templates/{TemplateName} Delete an email template · Delete email template #
Ask an LLM
“How do I remove an email template I no longer send?”
“Is there a limit on how quickly I can delete email templates?”
Tell an agent destructive · confirm first
Delete email template {template}.
Remove the {template} template from my account.
GET /v2/email/templates/{TemplateName} View an email template · Get email template #
Ask an LLM
“What subject line, HTML and text are in one of my saved email templates?”
“Can I look at a single email template by name?”
Tell an agent
Show email template {template}.
Get the subject, HTML and text parts of template {template}.
PUT /v2/email/templates/{TemplateName} Update an email template · Update email template #
Ask an LLM
“Can I change the HTML or subject line of a template I already saved?”
“How do I edit an existing personalized email template?”
Tell an agent
Update email template {template} with new content {content}.
Replace the subject and body of existing template {template} with {content}.
DELETE /v2/email/suppression/addresses/{EmailAddress} Remove an address from the suppression list · Delete suppressed destination #
Ask an LLM
“How do I start sending to an address again after it was suppressed for bouncing?”
“Can I take a single recipient off the account suppression list?”
Tell an agent destructive · confirm first
Remove {email} from my suppression list.
Unsuppress {email} so I can email it again.
GET /v2/email/suppression/addresses/{EmailAddress} Check one address on the suppression list · Get suppressed destination #
Ask an LLM
“Why is a particular recipient being suppressed, and when was it added?”
“Is a specific email address on my account's suppression list?”
Tell an agent
Look up {email} on my suppression list.
Tell me why {email} is suppressed.
GET /v2/email/account Get my account's sending status and limits · Get account #
Ask an LLM
“Is my account still in the sandbox, or does it have production access?”
“What's my current sending quota and is sending enabled in this region?”
Tell an agent
Show my email account's sending status and capabilities.
Check whether my account can send email in this region.
GET /v2/email/deliverability-dashboard/blacklist-report#BlacklistItemNames Check blacklists for my dedicated IPs · Get blacklist reports #
Ask an LLM
“Are any of my dedicated IP addresses on an email blocklist?”
“Which blacklists does a given dedicated IP appear on?”
Tell an agent
Show blacklist reports for {items}.
Check whether the dedicated IPs {items} are blacklisted.
GET /v2/email/dedicated-ips/{IP} Get details for one dedicated IP · Get dedicated ip #
Ask an LLM
“Which pool is a specific dedicated IP in, and how far along is its warm-up?”
“What can I learn about a single dedicated IP address?”
Tell an agent
Show details for dedicated IP {ip}.
Tell me the pool and warm-up status of {ip}.
GET /v2/email/dedicated-ips List dedicated IP addresses · Get dedicated ips #
Ask an LLM
“What dedicated IP addresses are associated with my account?”
“Can I list only the dedicated IPs in one pool?”
Tell an agent
List all my dedicated IP addresses.
List the dedicated IPs in pool {pool}.
GET /v2/email/deliverability-dashboard Check the Deliverability dashboard status · Get deliverability dashboard options #
Ask an LLM
“Is the Deliverability dashboard turned on for my account, and which domains does it cover?”
“When does my Deliverability dashboard subscription expire?”
Tell an agent
Show the status of my Deliverability dashboard.
List the domains subscribed to the Deliverability dashboard.
PUT /v2/email/deliverability-dashboard Turn the Deliverability dashboard on or off · Put deliverability dashboard option #
Ask an LLM
“How do I enable the Deliverability dashboard to get reputation and inbox placement data?”
“Can I choose which domains the Deliverability dashboard tracks?”
Tell an agent
Set the Deliverability dashboard enabled flag to {enabled}.
Enable the Deliverability dashboard ({enabled}) for domains {domains}.
GET /v2/email/deliverability-dashboard/test-reports/{ReportId} Get inbox placement test results · Get deliverability test report #
Ask an LLM
“What were the inbox versus spam results of a placement test I ran?”
“Can I see the outcome of one predictive inbox placement test by its ID?”
Tell an agent
Show the results of inbox placement test {report_id}.
Get the placement report for test {report_id}.
GET /v2/email/deliverability-dashboard/campaigns/{CampaignId} Get deliverability data for one campaign · Get domain deliverability campaign #
Ask an LLM
“What were the inbox rate and engagement numbers for a specific email campaign?”
“Which campaigns have deliverability data available?”
Tell an agent
Show deliverability data for campaign {campaign}.
Get the inbox placement stats of campaign {campaign}.
GET /v2/email/deliverability-dashboard/statistics-report/{Domain}#StartDate&EndDate Get inbox placement stats for a sending domain · Get domain statistics report #
Ask an LLM
“What were the inbox placement and engagement rates for my sending domain last month?”
“Can I get daily domain deliverability statistics for a date range?”
Tell an agent
Show inbox placement and engagement rates for {domain} from {start} to {end}.
Get the domain statistics report for {domain} between {start} and {end}.
GET /v2/email/identities/{EmailIdentity}/policies List an identity's sending authorization policies · Get email identity policies #
Ask an LLM
“Which sending authorization policies are attached to my domain?”
“Who have I authorized to send on behalf of a given email address?”
Tell an agent
List the sending authorization policies on {identity}.
Show all policy documents attached to identity {identity}.
GET /v2/email/import-jobs/{JobId} Check an import job's status · Get import job #
Ask an LLM
“Has my bulk contact import finished, and how many records failed?”
“What details can I see for a single import job?”
Tell an agent
Show the status of import job {job_id}.
Get the progress of import {job_id}.
GET /v2/email/deliverability-dashboard/test-reports List inbox placement tests · List deliverability test reports #
Ask an LLM
“Which predictive inbox placement tests have I run so far?”
“Does the list of placement tests include ones still in progress?”
Tell an agent
List all my inbox placement tests.
Show {page_size} placement test reports.
GET /v2/email/deliverability-dashboard/domains/{SubscribedDomain}/campaigns#StartDate&EndDate List campaigns sent from a domain · List domain deliverability campaigns #
Ask an LLM
“Which campaigns went out from my subscribed domain during a given period?”
“Can I get deliverability data for every campaign a domain sent in a time range?”
Tell an agent
List campaigns sent from {domain} between {start} and {end}.
Show deliverability for all {domain} campaigns from {start} to {end}.
POST /v2/email/vdm/recommendations List Virtual Deliverability Manager recommendations · List recommendations #
Ask an LLM
“What deliverability recommendations does Virtual Deliverability Manager have for my account?”
“Can I filter recommendations, for instance by type or status?”
Tell an agent
List my deliverability recommendations.
Show recommendations matching {filter}.
GET /v2/email/suppression/addresses List suppressed email addresses · List suppressed destinations #
Ask an LLM
“Which addresses are on my suppression list because they bounced or complained?”
“Can I list only addresses suppressed within a certain date range?”
Tell an agent
List every address on my suppression list.
Show addresses suppressed for {reason} between {start} and {end}.
PUT /v2/email/suppression/addresses Add an address to the suppression list · Put suppressed destination #
Ask an LLM
“How do I stop my account from ever sending to a certain address?”
“What reasons can I give when manually suppressing a recipient?”
Tell an agent
Add {email} to my suppression list for reason {reason}.
Suppress {email} as a {reason}.
GET /v2/email/tags#ResourceArn List a resource's tags · List tags for resource #
Ask an LLM
“What tags are on one of my email resources?”
“Can I see the key-value labels attached to a configuration set or identity?”
Tell an agent
List the tags on resource {arn}.
Show all tag keys and values for {arn}.
PUT /v2/email/account/dedicated-ips/warmup Toggle automatic warm-up for dedicated IPs · Put account dedicated ip warmup attributes #
Ask an LLM
“Can I turn off automatic warm-up for all my dedicated IP addresses at the account level?”
“Where do I enable automatic IP warm-up for new dedicated IPs?”
Tell an agent
Set account-wide automatic dedicated IP warm-up to {enabled}.
Turn on automatic warm-up for my dedicated IPs.
POST /v2/email/account/details Update account details and request production access · Put account details #
Ask an LLM
“How do I request to move my account out of the sandbox into production?”
“What use case details do I have to provide about my email sending?”
Tell an agent
Update my account details: mail type {mail_type}, website {website}, use case {use_case}.
Request production access for {mail_type} email from {website} describing {use_case}.
PUT /v2/email/account/sending Pause or resume sending for the account · Put account sending attributes #
Ask an LLM
“Can I pause all email sending from my account in this region?”
“How would I re-enable sending for my whole account?”
Tell an agent
Set account-wide sending enabled to {enabled}.
Pause email sending for my entire account.
PUT /v2/email/account/suppression Set account suppression list reasons · Put account suppression attributes #
Ask an LLM
“Can my account automatically suppress addresses that bounce or complain?”
“Which reasons add an address to the account-level suppression list?”
Tell an agent
Set my account suppression list to suppress on {reasons}.
Automatically suppress bounces and complaints at the account level.
PUT /v2/email/account/vdm Update account Virtual Deliverability Manager settings · Put account vdm attributes #
Ask an LLM
“How do I turn on Virtual Deliverability Manager for my whole account?”
“Can I enable engagement tracking and optimized shared delivery account-wide?”
Tell an agent
Set my account's VDM attributes to {vdm}.
Enable Virtual Deliverability Manager on my account with {vdm}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/delivery-options Assign an IP pool and TLS policy to a configuration set · Put configuration set delivery options #
Ask an LLM
“Can I make emails sent with one configuration set go out through a specific dedicated IP pool?”
“Is it possible to require TLS for messages using a configuration set?”
Tell an agent
Send mail for configuration set {config_set} through IP pool {pool}.
Set the TLS policy for {config_set} to {tls}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/reputation-options Toggle reputation metrics for a configuration set · Put configuration set reputation options #
Ask an LLM
“Can I collect bounce and complaint reputation metrics for one configuration set only?”
“How do I stop tracking reputation for a particular configuration set?”
Tell an agent
Set reputation metrics collection for {config_set} to {enabled}.
Turn on reputation metrics for configuration set {config_set}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/sending Pause or resume sending for a configuration set · Put configuration set sending options #
Ask an LLM
“Can I pause only the emails that use one configuration set, without stopping the whole account?”
“What's the way to resume sending for a paused configuration set?”
Tell an agent
Set sending enabled for configuration set {config_set} to {enabled}.
Pause sending for messages using {config_set}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/suppression-options Set suppression preferences for a configuration set · Put configuration set suppression options #
Ask an LLM
“Can one configuration set override which reasons trigger suppression?”
“How do I make a configuration set ignore complaints for suppression purposes?”
Tell an agent
Set suppression reasons for configuration set {config_set} to {reasons}.
Override account suppression settings on {config_set}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/tracking-options Set a custom domain for open and click tracking · Put configuration set tracking options #
Ask an LLM
“Can I use my own domain for open and click tracking links?”
“Where do I configure a custom redirect domain for a configuration set?”
Tell an agent
Use {domain} as the open and click tracking domain for {config_set}.
Set custom tracking redirect domain on configuration set {config_set}.
PUT /v2/email/configuration-sets/{ConfigurationSetName}/vdm-options Set VDM options for a configuration set · Put configuration set vdm options #
Ask an LLM
“Can I override Virtual Deliverability Manager settings for just one configuration set?”
“How often can I change VDM preferences on a configuration set?”
Tell an agent
Apply VDM options {vdm} to configuration set {config_set}.
Update Virtual Deliverability Manager preferences on {config_set}.
PUT /v2/email/dedicated-ips/{IP}/pool Move a dedicated IP to another pool · Put dedicated ip in pool #
Ask an LLM
“How do I move one of my dedicated IPs into a different pool?”
“Does the destination pool have to exist before I move an IP into it?”
Tell an agent
Move dedicated IP {ip} into pool {pool}.
Reassign {ip} to the {pool} pool.
PUT /v2/email/dedicated-ips/{IP}/warmup Set the warm-up percentage for a dedicated IP · Put dedicated ip warmup attributes #
Ask an LLM
“Can I manually set how far along a single dedicated IP is in its warm-up?”
“What warm-up percentage is a specific dedicated IP at, and can I change it?”
Tell an agent
Set the warm-up percentage of dedicated IP {ip} to {percent}.
Mark {ip} as {percent} percent warmed up.
PUT /v2/email/identities/{EmailIdentity}/configuration-set Set an identity's default configuration set · Put email identity configuration set attributes #
Ask an LLM
“Can every email sent from one domain automatically use a certain configuration set?”
“How do I attach a default configuration set to an existing identity?”
Tell an agent
Make {config_set} the default configuration set for {identity}.
Associate identity {identity} with configuration set {config_set}.
PUT /v2/email/identities/{EmailIdentity}/dkim Turn DKIM signing on or off for an identity · Put email identity dkim attributes #
Ask an LLM
“Can I temporarily disable DKIM signing for one of my domains?”
“How do I switch DKIM signing back on for an identity?”
Tell an agent
Set DKIM signing for {identity} to {enabled}.
Enable DKIM signing on identity {identity}.
PUT /v1/email/identities/{EmailIdentity}/dkim/signing Change DKIM key settings for a domain · Put email identity dkim signing attributes #
Ask an LLM
“Can I switch a domain from Easy DKIM to my own DKIM key, or back again?”
“Is it possible to rotate the DKIM key length for a domain identity?”
Tell an agent
Set the DKIM signing origin for domain {identity} to {origin}.
Use my own DKIM key {attributes} for {identity} with origin {origin}.
PUT /v2/email/identities/{EmailIdentity}/feedback Toggle bounce and complaint email forwarding · Put email identity feedback attributes #
Ask an LLM
“Can I stop getting bounce and complaint notifications by email for one identity?”
“What happens to feedback forwarding when I send from a particular address?”
Tell an agent
Set feedback forwarding for {identity} to {enabled}.
Turn off bounce and complaint email forwarding for {identity}.
PUT /v2/email/identities/{EmailIdentity}/mail-from Configure a custom Mail-From domain · Put email identity mail from attributes #
Ask an LLM
“How do I send with a custom MAIL FROM domain instead of the default one?”
“What happens if the MX record for my custom Mail-From domain fails?”
Tell an agent
Set the custom Mail-From domain for {identity} to {mail_from}.
Use Mail-From domain {mail_from} on {identity} with MX failure behavior {behavior}.
POST /v2/email/outbound-bulk-emails Send a templated email to many recipients · Send bulk email #
Ask an LLM
“Can I send one templated message to a batch of recipients with per-recipient data in a single call?”
“How do I do a bulk email send with default content and individual destinations?”
Tell an agent
Send a bulk email using {content} to these entries: {entries}.
Bulk send {content} from {from} to {entries}.
POST /v2/email/outbound-custom-verification-emails Send a custom verification email to an address · Send custom verification email #
Ask an LLM
“Can I verify a new sender address using my own branded verification email?”
“What happens when I send a custom verification email to someone?”
Tell an agent
Send verification template {template} to {email}.
Verify {email} with my custom verification email {template}.
POST /v2/email/outbound-emails Send an email message · Send email #
Ask an LLM
“How do I send a single email with Amazon SES?”
“Can I send a raw MIME message or a templated email, not just a simple one?”
Tell an agent
Send an email from {from} to {destination} with content {content}.
Send {content} to {destination} using configuration set {config_set}.
POST /v2/email/tags Add tags to a resource · Tag resource #
Ask an LLM
“Can I label an email identity or configuration set with tags for cost tracking?”
“How do I attach key-value tags to one of my resources?”
Tell an agent
Tag resource {arn} with {tags}.
Add tags {tags} to {arn}.
POST /v2/email/templates/{TemplateName}/render Preview a rendered email template · Test render email template #
Ask an LLM
“Can I preview how a template renders with sample replacement data before sending it?”
“What does the MIME output of a template look like filled in with test values?”
Tell an agent
Render template {template} with data {data}.
Preview {template} filled in with {data}.
DELETE /v2/email/tags#ResourceArn&TagKeys Remove tags from a resource · Untag resource #
Ask an LLM
“How do I strip specific tags off an email resource?”
“Can I remove several tag keys from a resource at once?”
Tell an agent destructive · confirm first
Remove tags {keys} from resource {arn}.
Untag {arn} by deleting keys {keys}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-ses:amazon-ses-email-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-ses-email-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 2019-09-27
  x-release: v4
  title: Amazon Simple Service Email API
  description: '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.'
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: sesv2
  x-aws-signingName: ses
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/sesv2-2019-09-27.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
      version: 1.0.0
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://email.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon SES V2 multi-region endpoint
- url: https://email.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon SES V2 multi-region endpoint
- url: http://email.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon SES V2 endpoint for China (Beijing) and China (Ningxia)
- url: https://email.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon SES V2 endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:


# --- truncated at 32 KB (387 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-ses/refs/heads/main/openapi/amazon-ses-email-api-openapi.yml