---
title: "Action autobroadcast__create"
description: "Creates a scheduled auto-broadcast for the current user."
---

# Action `autobroadcast__create`

> **System ID:** `action_autobroadcast__create`

## Description

Schedules an auto-broadcast message to the current user: one-time or on a schedule (weekday / day of month / time). You can set a relative time via `send_after` (for example, “3 days”) or absolute fields `weekday` / `monthday` / `daytime`.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **success** | Auto-broadcast created (the action always returns this branch) |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `template_id` | number | no | `null` | Message template ID |
| `alias` | string | no | `null` | Auto-broadcast alias (for later removal) |
| `one_time` | boolean / string | no | `false` | One-time broadcast (supports placeholders) |
| `send_after` | string | no | `null` | Relative time: `"2 days"`, `"3d"`, `"1 week"`, etc. |
| `weekday` | string | no | `null` | Weekday for a recurring broadcast (0–6, 0 = Sunday); placeholders |
| `monthday` | string | no | `null` | Day of month (1–31); placeholders |
| `daytime` | string | no | `null` | Time in `HH:mm` format; placeholders |

If `send_after` is set, the `weekday` / `monthday` / `daytime` fields from the config are not used — the time is calculated automatically.

## Configuration example

```json
{
  "template_id": 123,
  "alias": "follow_up",
  "one_time": true,
  "send_after": "3 days"
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)