HumHub icon

HumHub

Consume HumHub API (v.0.1.8)
Join our community

Actions126

Overview

This node operation creates a new space in the HumHub platform. It allows users to specify the space's name, description, visibility (public or private), and join policy (invite only, invite and request, or open to everyone). This operation is useful for organizing groups or communities within HumHub, enabling collaboration and content sharing among members.

Use Case Examples

  1. Creating a private space for a project team where only invited members can join.
  2. Setting up a public space for company-wide announcements accessible to all members.

Properties

Name Meaning
Authentication Method of authentication to use for the API request (Basic Auth or JWT Token).
Name The name of the space to be created.
Description A description of the space.
Is Visible Determines if the space is public (visible to members) or private (invisible).
Join Policy Defines how users can join the space: by invite only, by invite and request, or open to everyone.

Output

JSON

  • id - Unique identifier of the created space.
  • name - Name of the created space.
  • description - Description of the created space.
  • visibility - Visibility status of the space (public or private).
  • join_policy - Join policy setting of the space.

Dependencies

  • Requires authentication credentials for HumHub API (either Basic Auth or JWT Token).

Troubleshooting

  • Ensure that the 'Name' property is provided and is not empty, as it is required to create a space.
  • The 'Visibility' property must be a boolean; if an invalid value is provided, the API request may fail.
  • The 'Join Policy' must be one of the specified options (1, 2, or 3); invalid values will cause errors.
  • Authentication errors may occur if the provided credentials are invalid or expired; verify the credentials used.

Links

Discussion