---
name: bijection-aws-ses
description: "Evaluate and integrate the Amazon SES component with Bijection."
---

# Amazon SES

An AWS SES email component for Bijection.

- Package: @bijectionhq/aws-ses
- Category: Integrations
- Status: Preview
- License: Apache-2.0
- Bijection source (repository access required): https://github.com/bijectionhq/aws-ses/tree/b9da014d6c69eb4152f25f44126eb8e9f104cd96
- Upstream: https://github.com/orenaksakal/convex-aws-ses-emails-component/tree/1e344c9724cefc0f4fa4dd4d7cf52b7ed0f979af
- Documentation: https://docs.bijection.com/components/using
- Directory: https://bijection.com/components/aws-ses

## Get the source

Bijection repository access is required. Request access at https://bijection.com/contact.

```sh
git clone https://github.com/bijectionhq/aws-ses.git
cd aws-ses
git checkout b9da014d6c69eb4152f25f44126eb8e9f104cd96
```

## Before using this component

Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute.

## Integration workflow

1. Read the source README and package manifest at the recorded revision.
2. Confirm the required SDK, dependency availability, and runtime compatibility.
3. Follow the component's documented setup and configuration. Never invent an npm install command from a catalog package name.
4. Keep credentials in the project's existing secret store.
5. Follow the project's execution rules for verification and report what was actually checked.

## Original upstream skill

The following guidance describes convex-aws-ses. Its installation commands and APIs refer to the upstream package. Evaluate compatibility with the Bijection source separately.


# AWS SES Convex Component

## Instructions

Use AWS SES Convex Component to integrate aws ses with convex for reliable email delivery using queuing, rate limiting, and durable execution via workpools. This Convex component integrates directly with your backend.

### Installation

```bash
npm install convex-aws-ses
```

### Capabilities

- Send unlimited emails with automatic queuing and AWS SES rate limit compliance
- Ensure guaranteed delivery through durable execution that survives network failures
- Track email delivery status with built-in SNS webhook event handling
- Eliminate email infrastructure complexity with pre-configured workpool management

## Examples

### how to send emails from Convex backend reliably

The AWS SES Convex Component provides a queue-based email system that integrates directly with your Convex backend. It handles rate limiting, retries, and delivery tracking automatically through Convex workpools, ensuring emails are sent even during temporary AWS outages.

### Convex email delivery with retry logic

This component uses Convex workpools to implement durable execution for email delivery. If AWS SES is temporarily unavailable or rate limits are hit, the component automatically retries email sending until successful delivery is confirmed.

### AWS SES integration for Convex applications

The convex-aws-ses component connects your Convex project to AWS Simple Email Service with built-in queuing and event tracking. It respects AWS SES API rate limits and provides SNS webhook integration for delivery notifications.

### bulk email sending with Convex and AWS

This component handles high-volume email sending by queuing messages and processing them according to AWS SES rate limits. The workpool-based architecture ensures all emails are eventually delivered without overwhelming the AWS API.

## When NOT to use

- When a simpler built-in solution exists for your specific use case
- If you are not using Convex as your backend
- When the functionality provided by AWS SES Convex Component is not needed

## Troubleshooting

**Does the AWS SES Convex Component handle AWS rate limits automatically?**

Yes, the AWS SES Convex Component automatically respects AWS SES API rate limits to prevent throttling. It queues emails and processes them at a pace that stays within your AWS account's sending limits, ensuring reliable delivery without API errors.

**What happens if AWS SES is temporarily unavailable when using this component?**

The AWS SES Convex Component uses Convex workpools for durable execution, meaning emails will be retried automatically until successful delivery. If AWS SES experiences outages or network issues, queued emails will be processed once the service becomes available again.

**Can I track email delivery status with the AWS SES Convex Component?**

Yes, the AWS SES Convex Component includes event tracking through SNS webhooks. You can receive delivery notifications, bounces, and complaints directly in your Convex application, allowing you to monitor email performance and handle delivery issues programmatically.

**How does email queuing work in the AWS SES Convex Component?**

The AWS SES Convex Component implements a queue system that accepts emails at any rate and processes them through Convex workpools. This decouples email sending from your application logic, allowing you to send thousands of emails instantly while they are delivered in the background according to AWS limits.

## Resources

- [npm package](https://www.npmjs.com/package/convex-aws-ses)
- [GitHub repository](https://github.com/orenaksakal/convex-aws-ses-emails-component)
- [Live demo](https://github.com/orenaksakal/convex-aws-ses-emails-component/tree/main/example)
- [Convex Components Directory](https://www.convex.dev/components/convex-aws-ses)
- [Convex documentation](https://docs.convex.dev)