/resend

API Keys

Create, list, update, and delete API keys programmatically. No get endpoint exists.

SDK Methods

Create Parameters

Required: name

Optional: permission, domainId

• permission: "full_access" (default) or "sending_access"
• domainId: only applies when permission is "sending_access" — scopes the key to a single domain
• name: max 50 characters

Update Parameters

Required: name

Only name can be changed. permission and domainId are fixed at creation — recreate the key to change either.

Examples

Node.js

import { Resend } from 'resend';
const resend = new Resend(process.env.RESEND_API_KEY);

// Create a domain-scoped sending key
const { data, error } = await resend.apiKeys.create({
  name: 'Production Sending Key',
  permission: 'sending_access',
  domainId: 'd_abc123',
});

if (error) {
  console.error(error);
  return;
}

// IMPORTANT: This is the only time the token is returned -- store it now
console.log('API Key:', data.token);  // re_xxxxxxxxx
console.log('Key ID:', data.id);

// List all keys (tokens are NOT included in list response)
const { data: keys, error: listError } = await resend.apiKeys.list();

// Rename a key (only `name` is patchable)
const { data: updated, error: updateError } = await resend.apiKeys.update('api_key_id', {
  name: 'Production Sending Key v2',
});

// Delete a key
const { data: deleted, error: deleteError } = await resend.apiKeys.remove('api_key_id');

Python

import resend

resend.api_key = "re_xxxxxxxxx"

# Create a domain-scoped sending key
key = resend.ApiKeys.create({
    "name": "Production Sending Key",
    "permission": "sending_access",
    "domain_id": "d_abc123",
})

# IMPORTANT: Store the token immediately
print(f"API Key: {key['token']}")

# List all keys
keys = resend.ApiKeys.list()

# Rename a key (only "name" is patchable)
resend.ApiKeys.update({
    "id": "api_key_id",
    "name": "Production Sending Key v2",
})

# Delete a key
resend.ApiKeys.remove("api_key_id")

Common Mistakes

Response Fields

List returns metadata for each key: