Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Resend Audiences API

Create and manage Audiences through the Resend API.

Resend Audiences API is one of 13 APIs that Resend publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Audiences. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and 4 JSON Schemas.

This API exposes 10 operations across 5 paths, and defines 12 schemas. It is described by OpenAPI 3.0.3, at version 1.1.0.

Requests are made against a single base URL, https://api.resend.com.

10 operations 5 paths 12 schemas 3 DELETE4 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.1.0
Base URL
https://api.resend.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Resend Audiences API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 10

Across 5 paths, the API surfaces 10 operations — 3 DELETE, 4 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Audiences 10

Create and manage Audiences through the Resend API.

POST
/audiences
Create a list of contacts
body → 201
GET
/audiences
Retrieve a list of audiences
→ 200
DELETE
/audiences/{id}
Remove an existing audience
1 param → 200
GET
/audiences/{id}
Retrieve a single audience
1 param → 200
POST
/audiences/{audience_id}/contacts
Create a new contact
1 param body → 201
GET
/audiences/{audience_id}/contacts
Retrieve a list of contacts
1 param → 200
DELETE
/audiences/{audience_id}/contacts/{email}
Remove an existing contact by email
2 params → 200
DELETE
/audiences/{audience_id}/contacts/{id}
Remove an existing contact by id
2 params → 200
GET
/audiences/{audience_id}/contacts/{id}
Retrieve a single contact
2 params → 200
PATCH
/audiences/{audience_id}/contacts/{id}
Update a single contact
2 params body → 200

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are GetContactResponseSuccess (7 properties), CreateContactOptions (5 properties), UpdateContactOptions (4 properties), GetAudienceResponseSuccess (4 properties). Each schema is shown below with its type and property counts.

ListAudiencesResponseSuccess
object
2 properties
CreateAudienceOptions
object
1 property 1 required
ListContactsResponseSuccess
object
2 properties
RemoveAudienceResponseSuccess
object
3 properties
UpdateContactOptions
object
4 properties
RemoveContactResponseSuccess
object
3 properties
CreateContactResponseSuccess
object
2 properties
CreateContactOptions
object
5 properties 1 required
GetAudienceResponseSuccess
object
4 properties
CreateAudienceResponseSuccess
object
3 properties
GetContactResponseSuccess
object
7 properties
UpdateContactResponseSuccess
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

resend-audiences-api-openapi.yml Raw ↑

Other APIs Resend publishes across the network.

Resend Apis API
Resend Audience API
Resend Batch API
Resend Broadcasts API
Resend Cancel API
Resend Contacts API
Resend Domains API
Resend Email API
Resend Emails API
Resend Keys API
Resend Send API
Resend Verify API