Create Scheduled Message

await sdk.scheduledMessages.createScheduledMessage(options: CreateScheduledMessageOptions): Promise<ScheduledMessageData>

// Schedule a message for 3 seconds from now
const scheduledFor = Date.now() + 3 * 1000;

const scheduled = await sdk.scheduledMessages.createScheduledMessage({
  type: "send-message",
  payload: {
    chatGuid: "iMessage;-;+1234567890",
    message: "This is a scheduled message!",
    method: "apple-script",
  },
  scheduledFor,
  schedule: { type: "once" },
});

console.log(`Scheduled message ID: ${scheduled.id}`);
console.log(`Will send at: ${new Date(scheduledFor).toLocaleString()}`);

// Schedule a daily good morning message starting tomorrow at 9 AM
const tomorrow9am = new Date();
tomorrow9am.setDate(tomorrow9am.getDate() + 1);
tomorrow9am.setHours(9, 0, 0, 0);

const daily = await sdk.scheduledMessages.createScheduledMessage({
  type: "send-message",
  payload: {
    chatGuid: "iMessage;-;+1234567890",
    message: "Good morning!",
    method: "apple-script",
  },
  scheduledFor: tomorrow9am.getTime(),
  schedule: {
    type: "recurring",
    intervalType: "daily",
    interval: 1,
  },
});

console.log(`Scheduled recurring message ID: ${daily.id}`);
console.log(`First occurrence: ${tomorrow9am.toLocaleString()}`);
console.log(`Repeats: every day`);

// Schedule a weekly reminder every Monday at 8 AM
const nextMonday = new Date();
const daysUntilMonday = (1 - nextMonday.getDay() + 7) % 7 || 7;
nextMonday.setDate(nextMonday.getDate() + daysUntilMonday);
nextMonday.setHours(8, 0, 0, 0);

const weekly = await sdk.scheduledMessages.createScheduledMessage({
  type: "send-message",
  payload: {
    chatGuid: "iMessage;-;+1234567890",
    message: "Weekly team sync in 1 hour!",
    method: "apple-script",
  },
  scheduledFor: nextMonday.getTime(),
  schedule: {
    type: "recurring",
    intervalType: "weekly",
    interval: 1,
  },
});