---
title: "Action subscription__set"
description: "Subscribes the current user to a broadcast topic."
---

# Action `subscription__set`

> **System ID:** `action_subscription__set`  
> Also in scenario: `subscription__set`  
> Alias for the same logic: [`broadcast__subscribe`](/en/actionjail/reference/actions/broadcast__subscribe.md) (`action_broadcast__subscribe`).

## Description

Subscribes the current user to a broadcast topic so they receive messages for that topic. You can specify a template and time. Parameters support placeholders.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **success** | Subscription created successfully |
| **error** | Subscription failed (module unavailable, status error, or exception) |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `template_id` | string / number | no | — | Message template ID |
| `topic_id` | string | no | — | Broadcast topic identifier |
| `time` | string / number | no | — | Time for a scheduled subscription (e.g. `"09:00"`) |

## Configuration example

```json
{
  "topic_id": "newsletter",
  "template_id": 123,
  "time": "09:00"
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)
- [Action broadcast__subscribe](/en/actionjail/reference/actions/broadcast__subscribe.md)
- [Action subscription__check](/en/actionjail/reference/actions/subscription__check.md)
- [Action subscription__remove](/en/actionjail/reference/actions/subscription__remove.md)