---
title: "Schedule a Streak Huddle"
method: POST
path: "/api/rewards/admin/huddles"
tags: ["Rewards (admin)"]
---

# Schedule a Streak Huddle

`POST /api/rewards/admin/huddles`

## Request

- Base URL: `https://api.rewritelifestyle.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rewritelifestyle.ai/api/rewards/admin/huddles`
- Auth: HTTP bearer

The invite-list snapshot fires automatically once the configured lead time (default 7 days) is reached — nothing further to trigger by hand. Without `join_url` it follows the standing link (PUT huddles/standing-link).

## Request body

- ScheduleHuddleDto
  - `scheduled_at` string, required: When the huddle happens — the invite-list snapshot fires a configured number of days before this.
  - `join_url` string: This Huddle's own https link. Omit it and the Huddle follows the standing link (PUT huddles/standing-link), now and whenever that changes.
  - `duration_minutes` number: How long the call runs, in minutes (15–240). Default 60. (G27)
  - `host_coach_id` number: The hosting coach (an active coach). (G27)

## Response `201`

## Changes

- **2026-10-27** `5231b7914987`: 2 info
  - added the new optional request property `duration_minutes`
  - added the new optional request property `host_coach_id`
- **2026-09-12** `0d5ef02a4fbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/changes/api/rewards/admin/huddles/post.md)

---

[API](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api.md) - [All operations](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/revisions/28695827f27a?raw)