# Create/edit group

{% embed url="<https://www.youtube.com/watch?v=TEDkZXwdV5M>" %}

If you need to manage your users more efficiently and centralize administration in a single location, you are in the right place. Below, we present detailed documentation on the types of group registrations available in the application and the possibility of synchronization with existing groups in Entra ID (Azure AD).

The platform offers four methods to create groups, described below:

1. **Import via Entra ID**: Integrate directly with Entra ID to create groups from existing data.
2. **Sync via Entra ID**: Integrate directly with Entra ID on a recurring basis to create groups from existing data as changes occur in Entra ID.
3. **Import CSV File**: Import groups from a CSV file, facilitating bulk inclusion.
4. **Create Group Manually**: Create groups directly on the platform, with full control over settings.
5. **Register User via API**: Use API calls to create and manage groups, ideal for automated integrations.

These methods provide flexibility to adapt group management to your specific needs.

### General

In this tab, you can register the group's name and description (both required), the home page after login, and the authentication method to be used.

<figure><img src="/files/49a3ayDRPJinHbkiP1t2" alt=""><figcaption></figcaption></figure>

* **Expiration date**: Set an expiration date for the user. After this date, the user will not be able to access the system.
* **Home page after login**: Select a specific page or report for the user to be redirected to immediately after login. Make sure the user has access to the selected report or application.
* **Authentication method**: Choose the authentication method the user should use.

### Permissions

In this tab, you define the permissions that the group will grant to the users who belong to it when viewing a report.

<figure><img src="/files/jpSUg61yDhk4tIoddV22" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The permissions granted to the group only affect users in the reports that this group has access to. If you want to grant a permission to the user in all reports they have access to, the permissions applied directly to the user are applied to ALL reports that user has access to.
{% endhint %}

### Reports

Here you associate the group with one or more reports, so that this group grants access to these reports for the users belonging to the group.

To grant access to a report, simply check the report and then click the "Save" button.

To remove the user from the report, simply uncheck the report and then click the "Save" button.

<figure><img src="/files/Gq3N8CoMmsn1YEk3qCXB" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can also manage report permissions on the report management screen, but the context becomes the specific report rather than the group.
{% endhint %}

### Users

Here you associate the group with one or more users.

To add the user to the group, simply check the users and then click the "Save" button.

To remove the user from the group, simply uncheck the users and then click the "Save" button.

When the user belongs to a group, the report access permissions, RLS settings, and permissions are inherited from the group, which are added to the permissions the user already has.

<figure><img src="/files/d38OLu39TbqlP52qPR2t" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can also manage the association between Users and Groups on the [User Management](/administration-portal/users.md) screen, but the context becomes the specific user rather than the group.
{% endhint %}

### Assistants

If you are using Power Pilot assistants (Generative AI) in Power Embedded, this tab allows you to define which assistants will be available to the group.

On this screen you specify which assistants can be used by the group. [What is an assistant](https://powerembedded.com.br/power-pilot-ia/)

<figure><img src="/files/MFSJ8n59ICXbjcgEgzGn" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerembedded.com/administration-portal/groups/create-edit-group.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.