Manage Applications

    Create group

    post
    https://api.box.com/2.0
    /groups

    Creates a new group of users in an enterprise. Only users with admin permissions can create new groups.

    Request

    application/json

    Query Parameters

    string arrayin queryoptional
    id,type,name

    A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response.

    Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

    Request Body

    stringin bodyoptional
    "Customer Support Group - as imported from Active Directory"255

    A human readable description of the group.

    stringin bodyoptional
    AD:123456

    An arbitrary identifier that can be used by external group sync tools to link this Box Group to an external group.

    Example values of this field could be an Active Directory Object ID or a Google Group ID.

    We recommend you use of this field in order to avoid issues when group names are updated in either Box or external systems.

    stringin bodyoptional
    admins_only

    Specifies who can invite the group to collaborate on folders.

    When set to admins_only the enterprise admin, co-admins, and the group's admin can invite the group.

    When set to admins_and_members all the admins listed above and group members can invite the group.

    When set to all_managed_users all managed users in the enterprise can invite the group.

    Value is one of "admins_only", "admins_and_members", "all_managed_users"

    stringin bodyoptional
    admins_only

    Specifies who can see the members of the group.

    • `admins_only - the enterprise admin, co-admins, group's group admin
    • admins_and_members - all admins and group members
    • all_managed_users - all managed users in the enterprise

    Value is one of "admins_only", "admins_and_members", "all_managed_users"

    stringin bodyrequired
    Customer Support

    The name of the new group to be created

    stringin bodyoptional
    Active Directory255

    Keeps track of which external source this group is coming, for example "Active Directory", or "Okta".

    Setting this will also prevent Box admins from editing the group name and its members directly via the Box web application.

    This is desirable for one-way syncing of groups.

    Response

    application/jsonGroup

    Returns the new group object.

    You can now try out some of our APIs live, right here in the documentation.
    Log In

    Request Example

    cURL
    curl -X POST https://api.box.com/2.0/groups \
         -H "Authorization: Bearer <ACCESS_TOKEN>" \
         -H "Content-Type: application/json" \
         -d '{
           "name": "Customer Support"
         }'
    .NET
    var groupParams = new BoxGroupRequest()
    {
        Name = "Engineers"
    };
    BoxGroup group = await client.GroupsManager.CreateAsync(groupParams);
    Java
    BoxGroup.Info groupInfo = BoxGroup.createGroup(api, "My Group");
    Python
    created_group = client.create_group('Example Group')
    print('Created group with ID {0}'.format(created_group.id))
    Node
    client.groups.create('My group', {description: 'An example group'})
    	.then(group => {
    		/* group -> {
    			type: 'group',
    			id: '119720',
    			name: 'Box Employees',
    			created_at: '2013-05-16T15:27:57-07:00',
    			modified_at: '2013-05-16T15:27:57-07:00' }
    		*/
    	});

    Response Example

    {
      "id": 11446498,
      "type": "group",
      "name": "Support",
      "group_type": "managed_group",
      "created_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00",
      "provenance": "Active Directory",
      "external_sync_identifier": "AD:123456",
      "description": "Support Group - as imported from Active Directory",
      "invitability_level": "admins_only",
      "member_viewability_level": "admins_only"
    }