Update Broadcast

Update a broadcast to send to your contacts.

Path Parameters

The ID of the broadcast you want to update.

Body Parameters

The ID of the segment you want to send to.

from (string) — Sender email address.

To include a friendly name, use the format "Your Name <sender@domain.com>".
subject (string) — Email subject.

Reply-to email address. For multiple addresses, send as an array of strings.

html (string) — The HTML version of the message.
text (string) — The plain text version of the message.

If not provided, the HTML will be used to generate a plain text version. You can opt out of this behavior by setting value to an empty string.
react (React.ReactNode) — The React component used to write the message. Only available in the Node.js SDK.
name (string) — The friendly name of the broadcast. Only used for internal reference.

The topic ID that the broadcast will be scoped to.

Node.js

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.update(
  '49a3999c-0ce1-4ea6-ab68-afcd6dc2e794',
  {
    html: 'Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}',
  },
);

PHP

$resend = Resend::client('re_xxxxxxxxx');

$resend->broadcasts->update('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794', [
  'html' => 'Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}',
]);

Python

import resend

resend.api_key = "re_xxxxxxxxx"

params: resend.Broadcasts.UpdateParams = {
  "broadcast_id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
  "html": "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}"
}

resend.Broadcasts.update(params)

Ruby

require "resend"

Resend.api_key = "re_xxxxxxxxx"

params = {
  "broadcast_id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
  "html": "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}",
}
Resend::Broadcasts.update(params)

package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	params := &resend.UpdateBroadcastRequest{
		BroadcastId: "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
		Html:        "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}",
	}

	client.Broadcasts.Update(params)
}

Rust

use resend_rs::{types::UpdateBroadcastOptions, Resend, Result};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let id = "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794";
  let html = "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}";

  let opts = UpdateBroadcastOptions::new().with_html(html);

  let _broadcast = resend.broadcasts.update(id, opts).await?;

  Ok(())
}

Java

import com.resend.Resend;
import com.resend.services.broadcasts.model.UpdateBroadcastOptions;
import com.resend.services.broadcasts.model.UpdateBroadcastResponseSuccess;

Resend resend = new Resend("re_xxxxxxxxx");

UpdateBroadcastOptions params = UpdateBroadcastOptions.builder()
    .id("49a3999c-0ce1-4ea6-ab68-afcd6dc2e794")
    .html("Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}")
    .build();

UpdateBroadcastResponseSuccess data = resend.broadcasts().update(params);

.NET

using Resend;

IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI

var resp = await resend.BroadcastUpdateAsync(
    new Guid( "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794" ),
    new BroadcastUpdateData()
    {
        HtmlBody = "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}",
    }
);

cURL

curl -X PATCH 'https://api.resend.com/broadcasts/49a3999c-0ce1-4ea6-ab68-afcd6dc2e794' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "html": "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}"
}'

CLI

resend broadcasts update 49a3999c-0ce1-4ea6-ab68-afcd6dc2e794 \
  --html "Hi {{{contact.first_name|there}}}, you can unsubscribe here: {{{RESEND_UNSUBSCRIBE_URL}}}"

Response

{
  "object": "broadcast",
  "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
}