import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.oauthGrants.list();
{
"object": "list",
"has_more": false,
"data": [
{
"id": "650e8400-e29b-41d4-a716-446655440001",
"client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
"scopes": ["emails:send"],
"resource": null,
"created_at": "2026-04-08 00:11:13.110779+00",
"revoked_at": null,
"revoked_reason": null,
"client": {
"name": "Resend CLI",
"logo_uri": "https://example.com/logo.png"
}
},
{
"id": "650e8400-e29b-41d4-a716-446655440002",
"client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
"scopes": ["emails:send", "domains:read"],
"resource": "https://api.resend.com",
"created_at": "2026-04-07 00:11:13.110779+00",
"revoked_at": "2026-04-09 00:11:13.110779+00",
"revoked_reason": "revoked_from_api",
"client": {
"name": "Resend CLI",
"logo_uri": "https://example.com/logo.png"
}
}
]
}
List OAuth Grants
Retrieve a list of OAuth grants for the authenticated team.
GET
/
oauth
/
grants
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.oauthGrants.list();
{
"object": "list",
"has_more": false,
"data": [
{
"id": "650e8400-e29b-41d4-a716-446655440001",
"client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
"scopes": ["emails:send"],
"resource": null,
"created_at": "2026-04-08 00:11:13.110779+00",
"revoked_at": null,
"revoked_reason": null,
"client": {
"name": "Resend CLI",
"logo_uri": "https://example.com/logo.png"
}
},
{
"id": "650e8400-e29b-41d4-a716-446655440002",
"client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
"scopes": ["emails:send", "domains:read"],
"resource": "https://api.resend.com",
"created_at": "2026-04-07 00:11:13.110779+00",
"revoked_at": "2026-04-09 00:11:13.110779+00",
"revoked_reason": "revoked_from_api",
"client": {
"name": "Resend CLI",
"logo_uri": "https://example.com/logo.png"
}
}
]
}
Returns all of the team’s OAuth grants, including revoked ones. A grant’s
revoked_at and revoked_reason are null while it is active. They are set
once the grant is revoked.
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.oauthGrants.list();
{
"object": "list",
"has_more": false,
"data": [
{
"id": "650e8400-e29b-41d4-a716-446655440001",
"client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
"scopes": ["emails:send"],
"resource": null,
"created_at": "2026-04-08 00:11:13.110779+00",
"revoked_at": null,
"revoked_reason": null,
"client": {
"name": "Resend CLI",
"logo_uri": "https://example.com/logo.png"
}
},
{
"id": "650e8400-e29b-41d4-a716-446655440002",
"client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
"scopes": ["emails:send", "domains:read"],
"resource": "https://api.resend.com",
"created_at": "2026-04-07 00:11:13.110779+00",
"revoked_at": "2026-04-09 00:11:13.110779+00",
"revoked_reason": "revoked_from_api",
"client": {
"name": "Resend CLI",
"logo_uri": "https://example.com/logo.png"
}
}
]
}
Was this page helpful?
⌘I