import Courier from '@trycourier/courier';

const client = new Courier({
  apiKey: process.env['COURIER_API_KEY'], // This is the default and can be omitted
});

const broadcast = await client.broadcasts.schedule('broadcastId', {
  recipient_id: 'aud_01kx4h2jdafq8bk9amzvy6hbv0',
  recipient_type: 'audience',
  scheduled_to: '2026-08-01T15:00:00',
  timezone: 'America/New_York',
});

console.log(broadcast.id);

import os
from courier import Courier

client = Courier(
    api_key=os.environ.get("COURIER_API_KEY"),  # This is the default and can be omitted
)
broadcast = client.broadcasts.schedule(
    broadcast_id="broadcastId",
    recipient_id="aud_01kx4h2jdafq8bk9amzvy6hbv0",
    recipient_type="audience",
    scheduled_to="2026-08-01T15:00:00",
    timezone="America/New_York",
)
print(broadcast.id)

package main

import (
	"context"
	"fmt"

	"github.com/trycourier/courier-go"
	"github.com/trycourier/courier-go/option"
)

func main() {
	client := courier.NewClient(
		option.WithAPIKey("My API Key"),
	)
	broadcast, err := client.Broadcasts.Schedule(
		context.TODO(),
		"broadcastId",
		courier.BroadcastScheduleParams{
			ScheduleBroadcastRequest: courier.ScheduleBroadcastRequestParam{
				RecipientID:   "aud_01kx4h2jdafq8bk9amzvy6hbv0",
				RecipientType: courier.ScheduleBroadcastRequestRecipientTypeAudience,
				ScheduledTo:   "2026-08-01T15:00:00",
			},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", broadcast.ID)
}

package com.courier.example;

import com.courier.client.CourierClient;
import com.courier.client.okhttp.CourierOkHttpClient;
import com.courier.models.broadcasts.Broadcast;
import com.courier.models.broadcasts.BroadcastScheduleParams;
import com.courier.models.broadcasts.ScheduleBroadcastRequest;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        CourierClient client = CourierOkHttpClient.fromEnv();

        BroadcastScheduleParams params = BroadcastScheduleParams.builder()
            .broadcastId("broadcastId")
            .scheduleBroadcastRequest(ScheduleBroadcastRequest.builder()
                .recipientId("aud_01kx4h2jdafq8bk9amzvy6hbv0")
                .recipientType(ScheduleBroadcastRequest.RecipientType.AUDIENCE)
                .scheduledTo("2026-08-01T15:00:00")
                .build())
            .build();
        Broadcast broadcast = client.broadcasts().schedule(params);
    }
}

require "courier"

courier = Courier::Client.new(api_key: "My API Key")

broadcast = courier.broadcasts.schedule(
  "broadcastId",
  recipient_id: "aud_01kx4h2jdafq8bk9amzvy6hbv0",
  recipient_type: :audience,
  scheduled_to: "2026-08-01T15:00:00"
)

puts(broadcast)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Courier\Client;
use Courier\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('COURIER_API_KEY') ?: 'My API Key');

try {
  $broadcast = $client->broadcasts->schedule(
    'broadcastId',
    recipientID: 'aud_01kx4h2jdafq8bk9amzvy6hbv0',
    recipientType: 'audience',
    scheduledTo: '2026-08-01T15:00:00',
    timezone: 'America/New_York',
  );

  var_dump($broadcast);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using TryCourier;
using TryCourier.Models.Broadcasts;

CourierClient client = new();

BroadcastScheduleParams parameters = new()
{
    BroadcastID = "broadcastId",
    RecipientID = "aud_01kx4h2jdafq8bk9amzvy6hbv0",
    RecipientType = RecipientType.Audience,
    ScheduledTo = "2026-08-01T15:00:00",
};

var broadcast = await client.Broadcasts.Schedule(parameters);

Console.WriteLine(broadcast);

courier broadcasts schedule \
  --api-key 'My API Key' \
  --broadcast-id broadcastId \
  --recipient-id aud_01kx4h2jdafq8bk9amzvy6hbv0 \
  --recipient-type audience \
  --scheduled-to 2026-08-01T15:00:00

curl --request POST \
  --url https://api.courier.com/broadcasts/{broadcastId}/schedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient_type": "audience",
  "recipient_id": "aud_01kx4h2jdafq8bk9amzvy6hbv0",
  "scheduled_to": "2026-08-01T15:00:00",
  "timezone": "America/New_York"
}
'

{
  "id": "<string>",
  "name": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "created_by": "<string>",
  "updated_by": "<string>",
  "schedule": {
    "recipient_id": "<string>",
    "scheduled_to": "<string>",
    "timezone": "<string>"
  },
  "archived_at": "<string>",
  "archived_by": "<string>"
}

{
  "message": "<string>",
  "type": "invalid_request_error"
}

{
  "message": "<string>",
  "type": "invalid_request_error"
}

{
  "message": "<string>",
  "type": "invalid_request_error"
}

{
  "message": "<string>",
  "type": "invalid_request_error"
}