Send Tools

Draft, preview, test, schedule, and cancel message sends. 5 tools in this category.

sends.draft

Create a draft send targeting an audience with a template.

Roles: MARKETING_AND_ADMIN | draftByDefault: true

Field	Type	Required	Description
`templateId`	`string`	Yes	Template identifier
`audienceId`	`string`	Yes	Target audience identifier
`brandId`	`uuid`	Yes	Brand identifier
`subject`	`string`	No	Override template subject
`channel`	`enum(email\|sms\|push)`	No	Override template channel


{
  "tool": "sends.draft",
  "input": {
    "templateId": "tpl_xyz789",
    "audienceId": "aud_abc123",
    "brandId": "brand-uuid",
    "subject": "Your BPC-157 protocol update"
  }
}

sends.preview

Preview send content and estimated recipient count.

Roles: ALL_ROLES

Field	Type	Required	Description
`sendId`	`string`	Yes	Send identifier


{
  "tool": "sends.preview",
  "input": {
    "sendId": "snd_def456"
  }
}

sends.test

Send a test message to specified email addresses or phone numbers.

Roles: MARKETING_AND_ADMIN

Field	Type	Required	Description
`sendId`	`string`	Yes	Send identifier
`recipients`	`string[]`	Yes	Test recipient addresses


{
  "tool": "sends.test",
  "input": {
    "sendId": "snd_def456",
    "recipients": ["test@loop.health", "qa@loop.health"]
  }
}

sends.schedule

Schedule a send for future delivery.

Roles: MARKETING_AND_ADMIN

Field	Type	Required	Description
`sendId`	`string`	Yes	Send identifier
`scheduledAt`	`datetime`	Yes	UTC delivery time
`timezone`	`string`	No	Recipient timezone for local-time delivery


{
  "tool": "sends.schedule",
  "input": {
    "sendId": "snd_def456",
    "scheduledAt": "2026-05-20T10:00:00Z"
  }
}

sends.cancel

Cancel a scheduled send. Only works for sends in scheduled status.

Roles: MARKETING_AND_ADMIN

Field	Type	Required	Description
`sendId`	`string`	Yes	Send identifier
`reason`	`string`	No	Cancellation reason (logged in audit trail)


{
  "tool": "sends.cancel",
  "input": {
    "sendId": "snd_def456",
    "reason": "Content needs revision before sending"
  }
}