Skip to main content

Resend Python SDK

Code style: black Build License: MIT PyPI PyPI - Python Version


Installation

To install Resend Python SDK, simply execute the following command in a terminal:

pip install resend

Setup

First, you need to get an API key, which is available in the Resend Dashboard.

import resend
import os

resend.api_key = "re_yourkey"

Example

You can get an overview about all parameters in the Send Email API reference.

import os
import resend

resend.api_key = "re_yourkey"

params: resend.Emails.SendParams = {
    "from": "onboarding@resend.dev",
    "to": ["delivered@resend.dev"],
    "subject": "hi",
    "html": "<strong>hello, world!</strong>",
    "reply_to": "to@gmail.com",
    "bcc": "bcc@resend.dev",
    "cc": ["cc@resend.dev"],
    "tags": [
        {"name": "tag1", "value": "tagvalue1"},
        {"name": "tag2", "value": "tagvalue2"},
    ],
}

email: resend.Emails.SendResponse = resend.Emails.send(params)
print(email)

Async Support

The SDK supports async operations via httpx. Install the async extra:

pip install resend[async]

Once installed, async methods (suffixed with _async) work automatically — no extra setup needed:

import asyncio
import resend

resend.api_key = "re_yourkey"

async def main():
    params: resend.Emails.SendParams = {
        "from": "onboarding@resend.dev",
        "to": ["delivered@resend.dev"],
        "subject": "hi",
        "html": "<strong>hello, world!</strong>",
    }

    email: resend.Emails.SendResponse = await resend.Emails.send_async(params)
    print(email)

if __name__ == "__main__":
    asyncio.run(main())

Custom async client

To use a custom async HTTP client or configure options like timeouts, set resend.default_async_http_client:

import resend

resend.api_key = "re_yourkey"
resend.default_async_http_client = resend.HTTPXClient(timeout=60)

By default, HTTPXClient opens a new connection for every request. To reuse connections, pass your own httpx.AsyncClient. You own its lifecycle, so close it when you're done:

import httpx
import resend

async with httpx.AsyncClient(timeout=60) as client:
    resend.default_async_http_client = resend.HTTPXClient(client=client)
    ...

Legacy configurations that assign an AsyncHTTPClient to resend.default_http_client are also supported. Async requests select a client in this order:

  1. A replacement client assigned to resend.default_async_http_client.
  2. An AsyncHTTPClient assigned to resend.default_http_client.
  3. The automatic HTTPXClient, if httpx is installed.

Setting resend.default_async_http_client = None still permits the legacy fallback. Prefer the dedicated async setting for new code, so the sync client remains available for synchronous calls.

Metadata

Release files for resend 2.54.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for resend 2.54.0
File Size Uploaded Provenance Actions
resend-2.54.0.tar.gz 87.5 kB With provenance Details for resend-2.54.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for resend 2.54.0
File Interpreter ABI Platform Actions
resend-2.54.0-py3-none-any.whl Python 3 none any Details for resend-2.54.0-py3-none-any.whl

Total release size: 215.0 kB

Release files / resend-2.54.0.tar.gz

Download URL resend-2.54.0.tar.gz
Size 87.5 kB
Tags Source
SHA-256 checksum
How to use checksums
7003772bdb04797033643a61f598b55967324005bbd9f434d02f901840fdc6ae
BLAKE2b-256 checksum
How to use checksums
b70f3e2202cf26e0bed23de7751f7471238a856fa8cea52637505cdaa0ba442f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / resend-2.54.0-py3-none-any.whl

Download URL resend-2.54.0-py3-none-any.whl
Size 127.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
13aa42b1e56fc6d3d6110694aef7093d13a9c6d29fa5fee413ea96ecd808d14e
BLAKE2b-256 checksum
How to use checksums
77351e07fbf58d93e8a15673601098034fa4e0be3a244b643dcceb56cdbcde58
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for resend 2.54.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for resend-2.54.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.54.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page