# Amazon Pinpoint Email Service API

> Amazon Pinpoint Email Service API on Apizie: 42 endpoints (List all of the configuration sets associated with your Amazon Pinpoint account in the current region. In…, Create a configuration set. Configuration sets are groups of rules that you can apply to the emails you send…, Retrieve a list of event destinations that are associated with a configuration set. In Amazon Pinpoint,…, Create an event destination. In Amazon Pinpoint, events include message sends, deliveries, opens, clicks,…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-pinpoint-email`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://www.apizie.tech/api/cloud/amazonaws-pinpoint-email
- OpenAPI: https://www.apizie.tech/api/cloud/amazonaws-pinpoint-email/openapi.json

Amazon Pinpoint Email Service Welcome to the Amazon Pinpoint Email API Reference . This guide provides information about the Amazon Pinpoint Email API (version 1.0), including supported operations, data types,…

## Endpoints

### List all of the configuration sets associated with your Amazon Pinpoint account in the current region. In…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-configuration-sets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | A token returned from a previous call to ListConfigurationSets to indicate the position in the list of configuration sets. |
| PageSize | integer | no | The number of results to show in a single call to ListConfigurationSets . If the number of results is larger than the number you specified… |

### Create a configuration set. Configuration sets are groups of rules that you can apply to the emails you send…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/create-configuration-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Retrieve a list of event destinations that are associated with a configuration set. In Amazon Pinpoint,…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-configuration-set-event-destinations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that contains the event destination. |

### Create an event destination. In Amazon Pinpoint, events include message sends, deliveries, opens, clicks,…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/create-configuration-set-event-destination` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to add an event destination to. |
| body | object | yes | JSON request body |

### List all of the dedicated IP pools that exist in your Amazon Pinpoint account in the current AWS Region.
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-dedicated-ip-pools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | A token returned from a previous call to ListDedicatedIpPools to indicate the position in the list of dedicated IP pools. |
| PageSize | integer | no | The number of results to show in a single call to ListDedicatedIpPools . If the number of results is larger than the number you specified… |

### Create a new pool of dedicated IP addresses. A pool can include one or more dedicated IP addresses that are…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/create-dedicated-ip-pool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Create a new predictive inbox placement test. Predictive inbox placement tests can help you predict how your…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/create-deliverability-test-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns a list of all of the email identities that are associated with your Amazon Pinpoint account. An…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-email-identities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | A token returned from a previous call to ListEmailIdentities to indicate the position in the list of identities. |
| PageSize | integer | no | The number of results to show in a single call to ListEmailIdentities . If the number of results is larger than the number you specified… |

### Verifies an email identity for use with Amazon Pinpoint. In Amazon Pinpoint, an identity is an email address…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/create-email-identity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Get information about an existing configuration set, including the dedicated IP pool that it's associated…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-configuration-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to obtain more information about. |

### Delete an existing configuration set. In Amazon Pinpoint, configuration sets are groups of rules that you…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/delete-configuration-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to delete. |

### Update the configuration of an event destination for a configuration set. In Amazon Pinpoint, events include…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/update-configuration-set-event-destination` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that contains the event destination that you want to modify. |
| EventDestinationName | string | yes | The name of the event destination that you want to modify. |
| body | object | yes | JSON request body |

### Delete an event destination. In Amazon Pinpoint, events include message sends, deliveries, opens, clicks,…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/delete-configuration-set-event-destination` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that contains the event destination that you want to delete. |
| EventDestinationName | string | yes | The name of the event destination that you want to delete. |

### Delete a dedicated IP pool.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/delete-dedicated-ip-pool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| PoolName | string | yes | The name of the dedicated IP pool that you want to delete. |

### Provides information about a specific identity associated with your Amazon Pinpoint account, including the…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-email-identity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| EmailIdentity | string | yes | The email identity that you want to retrieve details for. |

### Deletes an email identity that you previously verified for use with Amazon Pinpoint. An identity can be…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/delete-email-identity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| EmailIdentity | string | yes | The identity (that is, the email address or domain) that you want to delete from your Amazon Pinpoint account. |

### Obtain information about the email-sending status and capabilities of your Amazon Pinpoint account in the…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Retrieve a list of the blacklists that your dedicated IP addresses appear on.
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-blacklist-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| BlacklistItemNames | array | yes | A list of IP addresses that you want to retrieve blacklist information about. You can only specify the dedicated IP addresses that you use… |

### Get information about a dedicated IP address, including the name of the dedicated IP pool that it's…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-dedicated-ip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| IP | string | yes | The IP address that you want to obtain more information about. The value you specify has to be a dedicated IP address that's assocaited… |

### List the dedicated IP addresses that are associated with your Amazon Pinpoint account.
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-dedicated-ips` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| PoolName | string | no | The name of the IP pool that the dedicated IP address is associated with. |
| NextToken | string | no | A token returned from a previous call to GetDedicatedIps to indicate the position of the dedicated IP pool in the list of IP pools. |
| PageSize | integer | no | The number of results to show in a single call to GetDedicatedIpsRequest . If the number of results is larger than the number you… |

### Retrieve information about the status of the Deliverability dashboard for your Amazon Pinpoint account. When…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-deliverability-dashboard-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Enable or disable the Deliverability dashboard for your Amazon Pinpoint account. When you enable the…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-deliverability-dashboard-option` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Retrieve the results of a predictive inbox placement test.
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-deliverability-test-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ReportId | string | yes | A unique string that identifies the predictive inbox placement test. |

### Retrieve all the deliverability data for a specific campaign. This data is available for a campaign only if…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-domain-deliverability-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| CampaignId | string | yes | The unique identifier for the campaign. Amazon Pinpoint automatically generates and assigns this identifier to a campaign. This value is… |

### Retrieve inbox placement and engagement rates for the domains that you use to send email.
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/get-domain-statistics-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Domain | string | yes | The domain that you want to obtain deliverability metrics for. |
| StartDate | string | yes | The first day (in Unix time) that you want to obtain domain deliverability metrics for. |
| EndDate | string | yes | The last day (in Unix time) that you want to obtain domain deliverability metrics for. The EndDate that you specify has to be less than or… |

### Show a list of the predictive inbox placement tests that you've performed, regardless of their statuses. For…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-deliverability-test-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | A token returned from a previous call to ListDeliverabilityTestReports to indicate the position in the list of predictive inbox placement… |
| PageSize | integer | no | The number of results to show in a single call to ListDeliverabilityTestReports . If the number of results is larger than the number you… |

### Retrieve deliverability data for all the campaigns that used a specific domain to send email during a…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-domain-deliverability-campaigns` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| StartDate | string | yes | The first day, in Unix time format, that you want to obtain deliverability data for. |
| EndDate | string | yes | The last day, in Unix time format, that you want to obtain deliverability data for. This value has to be less than or equal to 30 days… |
| SubscribedDomain | string | yes | The domain to obtain deliverability data for. |
| NextToken | string | no | A token that’s returned from a previous call to the ListDomainDeliverabilityCampaigns operation. This token indicates the position of a… |
| PageSize | integer | no | The maximum number of results to include in response to a single call to the ListDomainDeliverabilityCampaigns operation. If the number of… |

### Retrieve a list of the tags (keys and values) that are associated with a specified resource. A tag is a…
`GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that you want to retrieve tag information for. |

### Enable or disable the automatic warm-up feature for dedicated IP addresses.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-account-dedicated-ip-warmup-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Enable or disable the ability of your account to send email.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-account-sending-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Associate a configuration set with a dedicated IP pool. You can use dedicated IP pools to create groups of…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-configuration-set-delivery-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to associate with a dedicated IP pool. |
| body | object | yes | JSON request body |

### Enable or disable collection of reputation metrics for emails that you send using a particular configuration…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-configuration-set-reputation-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to enable or disable reputation metric tracking for. |
| body | object | yes | JSON request body |

### Enable or disable email sending for messages that use a particular configuration set in a specific AWS Region.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-configuration-set-sending-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to enable or disable email sending for. |
| body | object | yes | JSON request body |

### Specify a custom domain to use for open and click tracking elements in email that you send using Amazon…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-configuration-set-tracking-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ConfigurationSetName | string | yes | The name of the configuration set that you want to add a custom tracking domain to. |
| body | object | yes | JSON request body |

### Move a dedicated IP address to an existing dedicated IP pool. The dedicated IP address that you specify must…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-dedicated-ip-in-pool` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| IP | string | yes | The IP address that you want to move to the dedicated IP pool. The value you specify has to be a dedicated IP address that's associated… |
| body | object | yes | JSON request body |

### 
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-dedicated-ip-warmup-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| IP | string | yes | The dedicated IP address that you want to update the warm-up attributes for. |
| body | object | yes | JSON request body |

### Used to enable or disable DKIM authentication for an email identity.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-email-identity-dkim-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| EmailIdentity | string | yes | The email identity that you want to change the DKIM settings for. |
| body | object | yes | JSON request body |

### Used to enable or disable feedback forwarding for an identity. This setting determines what happens when an…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-email-identity-feedback-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| EmailIdentity | string | yes | The email identity that you want to configure bounce and complaint feedback forwarding for. |
| body | object | yes | JSON request body |

### Used to enable or disable the custom Mail-From domain configuration for an email identity.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/put-email-identity-mail-from-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| EmailIdentity | string | yes | The verified email identity that you want to set up the custom MAIL FROM domain for. |
| body | object | yes | JSON request body |

### Sends an email message. You can use the Amazon Pinpoint Email API to send two types of messages: Simple – A…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/send-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Add one or more tags (keys and values) to a specified resource. A tag is a label that you optionally define…
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Remove one or more tags (keys and values) from a specified resource.
`POST https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that you want to remove one or more tags from. |
| TagKeys | array | yes | The tags (tag keys) that you want to remove from the resource. When you specify a tag key, the action removes both that key and its… |

## Example
```
curl "https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-configuration-sets" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon Pinpoint Email Service API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/cloud:amazonaws-pinpoint-email/list-configuration-sets with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon Pinpoint Email Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon Pinpoint Email Service itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon Pinpoint Email Service API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-pinpoint-email.

### What is the status of the Amazon Pinpoint Email Service API?
Needs your own provider key (bring your own key)