Resend

Resend Broadcasts API

The Broadcasts API from Resend — 2 operation(s) for broadcasts.

GitHub OpenAPI

Operations 4

POST /broadcasts Create a broadcast
GET /broadcasts Retrieve a list of broadcasts
DELETE /broadcasts/{id} Remove an existing broadcast that is in the draft status
GET /broadcasts/{id} Retrieve a single broadcast

Documentation

📖
Documentation
https://resend.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/openapi/resend-broadcasts-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/asyncapi/resend-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/json-schema/resend-email-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/json-schema/resend-audience-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/json-schema/resend-domain-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/json-structure/resend-email-structure.json

Other Resources

🔗
Webhooks
https://resend.com/docs/dashboard/webhooks/introduction
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/json-ld/resend-context.jsonld
🔗
SpectralRules
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/rules/resend-rules.yml
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/vocabulary/resend-vocabulary.yml
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/resend/refs/heads/main/graphql/resend-graphql.md

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/resend-broadcasts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

resend-broadcasts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Resend Broadcasts API
  version: 1.1.0
  description: '

    Resend is transforming email for developers. Simple interface, easy

    integrations, handy templates. '
servers:
- url: https://api.resend.com
security:
- bearerAuth: []
tags:
- name: Broadcasts
paths:
  /broadcasts:
    post:
      tags:
      - Broadcasts
      summary: Create a broadcast
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBroadcastOptions'
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateBroadcastResponseSuccess'
    get:
      tags:
      - Broadcasts
      summary: Retrieve a list of broadcasts
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBroadcastsResponseSuccess'
  /broadcasts/{id}:
    delete:
      tags:
      - Broadcasts
      summary: Remove an existing broadcast that is in the draft status
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          description: The Broadcast ID.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveBroadcastResponseSuccess'
    get:
      tags:
      - Broadcasts
      summary: Retrieve a single broadcast
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          description: The Broadcast ID.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBroadcastResponseSuccess'
components:
  schemas:
    GetBroadcastResponseSuccess:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the broadcast.
          example: e169aa45-1ecf-4183-9955-b1499d5701d3
        name:
          type: string
          description: Name of the broadcast.
          example: November announcements
        audience_id:
          type: string
          description: Unique identifier of the audience this broadcast will be sent to.
        from:
          type: string
          description: The email address of the sender.
          example: Acme <onboarding@resend.dev>
        subject:
          type: string
          description: The subject line of the email.
          example: Hello World
        reply_to:
          type: array
          items:
            type: string
          description: The email addresses to which replies should be sent.
        preview_text:
          type: string
          description: The preview text of the email.
          example: Here are our announcements
        status:
          type: string
          description: The status of the broadcast.
          example: draft
        created_at:
          type: string
          format: date-time
          description: Timestamp indicating when the broadcast was created.
          example: '2023-10-06T22:59:55.977Z'
        scheduled_at:
          type: string
          format: date-time
          description: Timestamp indicating when the broadcast is scheduled to be sent.
          example: '2023-10-06T22:59:55.977Z'
        sent_at:
          type: string
          format: date-time
          description: Timestamp indicating when the broadcast was sent.
          example: '2023-10-06T22:59:55.977Z'
    ListBroadcastsResponseSuccess:
      type: object
      properties:
        object:
          type: string
          description: Type of the response object.
          example: list
        data:
          type: array
          description: Array containing broadcast information.
          items:
            type: object
            properties:
              id:
                type: string
                description: Unique identifier for the broadcast.
                example: e169aa45-1ecf-4183-9955-b1499d5701d3
              name:
                type: string
                description: Name of the broadcast.
                example: November announcements
              audience_id:
                type: string
                description: Unique identifier of the audience this broadcast will be sent to.
                example: 78261eea-8f8b-4381-83c6-79fa7120f1cf
              status:
                type: string
                description: The status of the broadcast.
                example: draft
              created_at:
                type: string
                format: date-time
                description: Timestamp indicating when the broadcast was created.
                example: '2023-10-06T22:59:55.977Z'
              scheduled_at:
                type: string
                format: date-time
                description: Timestamp indicating when the broadcast is scheduled to be sent.
                example: '2023-10-06T22:59:55.977Z'
              sent_at:
                type: string
                format: date-time
                description: Timestamp indicating when the broadcast was sent.
                example: '2023-10-06T22:59:55.977Z'
    RemoveBroadcastResponseSuccess:
      type: object
      properties:
        id:
          type: string
          description: The ID of the broadcast.
          example: 78261eea-8f8b-4381-83c6-79fa7120f1cf
        object:
          type: string
          description: Type of the response object.
          example: broadcast
        deleted:
          type: boolean
          description: The deleted attribute indicates that the corresponding broadcast has been deleted.
          example: true
    CreateBroadcastResponseSuccess:
      type: object
      properties:
        id:
          type: string
          description: The ID of the broadcast.
          example: 78261eea-8f8b-4381-83c6-79fa7120f1cf
        object:
          type: string
          description: The object type of the response.
          example: broadcast
    CreateBroadcastOptions:
      type: object
      required:
      - audience_id
      - from
      - subject
      properties:
        name:
          type: string
          description: Name of the broadcast.
        audience_id:
          type: string
          description: Unique identifier of the audience this broadcast will be sent to.
        from:
          type: string
          description: The email address of the sender.
        subject:
          type: string
          description: The subject line of the email.
        reply_to:
          type: array
          items:
            type: string
          description: The email addresses to which replies should be sent.
        preview_text:
          type: string
          description: The preview text of the email.
          example: Here are our announcements
        html:
          type: string
          description: The HTML version of the message.
        text:
          type: string
          description: The plain text version of the message.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer