create_discussion
Create a new discussion thread in a Loomio group by specifying a title and group ID. Set the body, visibility, and notification recipients as needed.
Instructions
Create a new Loomio discussion (thread) in a group. Required: title, group_id. The private field is auto-resolved from the group's discussion_privacy_options when omitted (matches Loomio's web UI default — public_only → false, anything else → true); pass it explicitly to override. Optional description + description_format ('md' / 'html') set the body. Notification recipients can be specified via recipient_audience: 'group' (notify all members), recipient_user_ids (explicit user ids), or recipient_emails (invite new people), optionally with a recipient_message. Caller must be allowed to start discussions in the group.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Discussion title (required). | |
| group_id | Yes | ID of the Loomio group to create the discussion in (required). | |
| description | No | Optional discussion body. | |
| description_format | No | Format of `description`. Defaults to Loomio's group default when omitted. | |
| private | No | Visibility: true = group members only, false = publicly visible. Loomio's validator enforces this against the group's `discussion_privacy_options`: `public_only` requires `private: false`, `private_only` requires `private: true`, `public_or_private` allows either. When omitted, the connector reads the group's setting and chooses the value Loomio's web UI would pick: `false` for `public_only`, `true` otherwise (matching `Group#discussion_private_default`). Pass an explicit value to override. | |
| recipient_audience | No | Audience selector for notification recipients. 'group' = notify whole group. | |
| recipient_user_ids | No | Explicit list of user IDs to notify. | |
| recipient_emails | No | Explicit list of email addresses to notify. | |
| recipient_message | No | Optional custom message to include in notifications. |