userGroup/enable

Re-enable a previously disabled Slack User Group. Restores @mention notifications for all group members without requiring membership to be re-added.

Member Preservation: When a group is re-enabled, its previous membership list is fully restored. Members that were in the group when it was disabled will receive @mention notifications again immediately after enabling. You do not need to call userGroup/addUsers unless the membership list has changed.

When to Use

Re-enable a seasonal group at the start of a new cycle (e.g. @summer-interns at the start of a new internship cohort).
Restore a group after a reorganization completes and the new membership structure is in place.
Reactivate a temporarily disabled project group when work on that project resumes.

Configuration

Connection

Field	Required	Description
`botToken`	Required	Slack Bot Token starting with `xoxb-`. Requires the `usergroups:write` OAuth scope.

Operation Fields

Field	Required	Description
`userGroupId`	Required	The Slack user group identifier (starts with `S`, e.g. `S08ABCDEFGH`). Obtain from `userGroup/getMany` (include disabled groups with `includeDisabled: true`).

Sample Configuration

{
  "operation": "userGroup/enable",
  "connection": {
    "botToken": "{{ $credentials.slackBot.token }}"
  },
  "userGroupId": "{{ $input.userGroupId }}"
}

Validation Errors

Error Code	Cause	Resolution
`no_such_subteam`	No user group with the given ID exists.	Verify the group ID using `userGroup/getMany` with `includeDisabled: true`.
`already_enabled`	The group is already active.	Treat as non-fatal — the desired end state (enabled) is already achieved.
`missing_scope`	Token lacks the `usergroups:write` scope.	Add `usergroups:write` under OAuth & Permissions and reinstall the app.
`invalid_auth`	Bot token is invalid or revoked.	Regenerate the token and update the credential store.

Output

Success Port

Field	Type	Description
`userGroupId`	string	ID of the re-enabled group.
`status`	string	`"success"` when the group was successfully enabled.
`errorCode`	string	Empty on success. Slack API error code on failure.
`payload`	object	Raw Slack API response including the updated group object with restored member count.

Error Port

Activated when the group does not exist or the token lacks write permissions. The already_enabled error should be treated as non-fatal in idempotent workflows.

Sample Output

{
  "userGroupId": "S08INTERNS1",
  "status": "success",
  "errorCode": "",
  "payload": {
    "ok": true,
    "usergroup": {
      "id": "S08INTERNS1",
      "name": "Summer Interns 2026",
      "handle": "summer-interns",
      "user_count": 12,
      "date_delete": 0
    }
  }
}

Expression Reference

Expression	Result
`{{ $output.enableGroup.userGroupId }}`	Group ID — pass to `userGroup/addUsers` to update membership after re-enabling.
`{{ $output.enableGroup.status }}`	Status string for conditional branching.
`{{ $output.enableGroup.payload.usergroup.user_count }}`	Restored member count after re-enabling — useful for confirmation logging.

Node Policies & GuardRails

Policy Area	Recommendation
Membership Refresh	After re-enabling, call `userGroup/addUsers` with the updated membership list if the cycle has new participants. Previous members are restored but may need to be replaced for the new cycle.
Idempotency	The `already_enabled` error means the group is already active. Wire the error port to log and continue rather than failing the workflow.
Disabled Group Discovery	To find the ID of a previously disabled group, call `userGroup/getMany` with `includeDisabled: true` and search by handle or name.
Notification Burst	Re-enabling a large group and immediately @mentioning it will send notifications to all members at once. Stage the @mention separately and notify members in advance if the notification volume may be disruptive.
Audit Logging	Log enable events with the group ID, timestamp, and triggering workflow for governance and compliance traceability.

Examples

Re-Enable Intern Group for New Cohort

At the start of the summer program, re-enable the intern group and update membership with the new cohort.

// Step 1: Re-enable
{
  "operation": "userGroup/enable",
  "userGroupId": "S08INTERNS1"
}
// Step 2: Replace membership with new cohort
{
  "operation": "userGroup/addUsers",
  "userGroupId": "S08INTERNS1",
  "userIds": "{{ $input.newCohortUserIds }}"
}

Restore Group After Reorganization

After a department restructure completes, re-enable the department group and update it to reflect the new team.

{
  "operation": "userGroup/enable",
  "userGroupId": "{{ $input.deptGroupId }}"
}

Re-enable Project Group When Work Resumes

When a paused project is reactivated in the project management system, re-enable its Slack group.

{
  "operation": "userGroup/enable",
  "userGroupId": "{{ $trigger.project.slackGroupId }}"
}