Skip to main content
id
string
Example: trigger_123Match pattern: trigger_\d+
object
string
The resource in the response. Always trigger.Allowed value: trigger
created_at
string<date-time>
ISO 8601 date-time string.Example: 2023-01-01T10:00+00:00
updated_at
string<date-time>
ISO 8601 date-time string.Example: 2023-01-01T10:00+00:00
type
string
required
One of immediate, schedule or recurring.Allowed values: schedule, immediate, recurring
schedule
object
Used when launching a campaign to send at a specific time in the future.
immediate
object
Used when launching a campaign to send immediately.
recurring
object
Used when launching a campaign to run on a recurring schedule.

Example (Schedule)

{
  "id": "trigger_123",
  "object": "trigger",
  "created_at": "2023-01-01T10:00+00:00",
  "updated_at": "2023-01-01T10:00+00:00",
  "type": "schedule",
  "schedule": {
    "scheduled_at": "2023-01-01T10:00+10:00",
    "batches": {
      "count": 3,
      "delay": 3600
    }
  }
}

Example (Immediate)

{
  "id": "trigger_456",
  "object": "trigger",
  "created_at": "2023-01-01T10:00+00:00",
  "updated_at": "2023-01-01T10:00+00:00",
  "type": "immediate",
  "immediate": {
    "batches": {
      "count": 2,
      "delay": 1800
    }
  }
}

Example (Recurring)

{
  "id": "trigger_789",
  "object": "trigger",
  "created_at": "2023-01-01T10:00+00:00",
  "updated_at": "2023-01-01T10:00+00:00",
  "type": "recurring",
  "recurring": {
    "schedule": "* 12 2 * *",
    "next_scheduled_at": "2023-02-01T12:00+10:00",
    "batches": {
      "count": 1,
      "delay": 60
    }
  }
}