Skip to main content
POST
/
audiences
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.audiences.create({
  name: 'Registered Users',
});
$resend = Resend::client('re_xxxxxxxxx');

$resend->audiences->create([
  'name' => 'Registered Users'
]);
import resend

resend.api_key = "re_xxxxxxxxx"

params: resend.Audiences.CreateParams = {
  "name": "Registered Users"
}

resend.Audiences.create(params)
require "resend"

Resend.api_key = "re_xxxxxxxxx"

Resend::Audiences.create({ name: "Registered Users" })
package main

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

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

	params := &resend.CreateAudienceRequest{
		Name: "Registered Users",
	}

	client.Audiences.Create(params)
}
use resend_rs::{Resend, Result};

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

  let _audience = resend.audiences.create("Registered Users").await?;

  Ok(())
}
import com.resend.*;

public class Main {
    public static void main(String[] args) {
        Resend resend = new Resend("re_xxxxxxxxx");

        CreateAudienceOptions params = CreateAudienceOptions
                .builder()
                .name("Registered Users").build();

        CreateAudienceResponseSuccess data = resend.audiences().create(params);
    }
}
using Resend;

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

var resp = await resend.AudienceAddAsync( "Registered Users" );
Console.WriteLine( "AudienceId={0}", resp.Content );
curl -X POST 'https://api.resend.com/audiences' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "name": "Registered Users"
}'
{
  "object": "audience",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Registered Users"
}
Audiences are deprecated in favor of Segments.These endpoints still work, but will be removed in the future.Or contact support if you have any questions.

Body Parameters

name
string
required
The name of the audience you want to create.
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.audiences.create({
  name: 'Registered Users',
});
$resend = Resend::client('re_xxxxxxxxx');

$resend->audiences->create([
  'name' => 'Registered Users'
]);
import resend

resend.api_key = "re_xxxxxxxxx"

params: resend.Audiences.CreateParams = {
  "name": "Registered Users"
}

resend.Audiences.create(params)
require "resend"

Resend.api_key = "re_xxxxxxxxx"

Resend::Audiences.create({ name: "Registered Users" })
package main

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

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

	params := &resend.CreateAudienceRequest{
		Name: "Registered Users",
	}

	client.Audiences.Create(params)
}
use resend_rs::{Resend, Result};

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

  let _audience = resend.audiences.create("Registered Users").await?;

  Ok(())
}
import com.resend.*;

public class Main {
    public static void main(String[] args) {
        Resend resend = new Resend("re_xxxxxxxxx");

        CreateAudienceOptions params = CreateAudienceOptions
                .builder()
                .name("Registered Users").build();

        CreateAudienceResponseSuccess data = resend.audiences().create(params);
    }
}
using Resend;

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

var resp = await resend.AudienceAddAsync( "Registered Users" );
Console.WriteLine( "AudienceId={0}", resp.Content );
curl -X POST 'https://api.resend.com/audiences' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "name": "Registered Users"
}'
{
  "object": "audience",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Registered Users"
}