Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

Create Audience

POST

/

audiences

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

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

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

resend.api_key = "re_xxxxxxxxx"

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

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

Resend.api_key = "re_xxxxxxxxx"

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

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

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

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

	client.Audiences.Create(params)
}
Java
import com.resend.Resend;
import com.resend.core.exception.ResendException;
import com.resend.services.audiences.model.CreateAudienceOptions;
import com.resend.services.audiences.model.CreateAudienceResponseSuccess;

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

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

        CreateAudienceResponseSuccess data = resend.audiences().create(params);
    }
}
.NET
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
curl -X POST 'https://api.resend.com/audiences' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "name": "Registered Users"
}'
Response
{
  "object": "audience",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Registered Users"
}

string

required

The name of the audience you want to create.

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

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

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

resend.api_key = "re_xxxxxxxxx"

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

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

Resend.api_key = "re_xxxxxxxxx"

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

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

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

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

	client.Audiences.Create(params)
}
Java
import com.resend.Resend;
import com.resend.core.exception.ResendException;
import com.resend.services.audiences.model.CreateAudienceOptions;
import com.resend.services.audiences.model.CreateAudienceResponseSuccess;

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

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

        CreateAudienceResponseSuccess data = resend.audiences().create(params);
    }
}
.NET
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
curl -X POST 'https://api.resend.com/audiences' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "name": "Registered Users"
}'
JSON
{
  "object": "audience",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Registered Users"
}

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu