> For the complete documentation index, see [llms.txt](https://everyday-digital.gitbook.io/falkor-dev-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://everyday-digital.gitbook.io/falkor-dev-docs/groups/concepts.md).

# Concepts

In [Groups & Cohorts ](https://everyday-digital.gitbook.io/groups-cohort-docs)users can be categorised into segments. This allows for private content distribution and filtering in [Analytics](https://docs.falkor.io/analytics/working-with-analytics/types). Groups also [send invites](https://docs.falkor.io/groups/managing-users/user-notifications) to users that are added to a group for the first time.

### Invites

[Invites](https://everyday-digital.gitbook.io/groups-cohort-docs/groups/inviting-users#getting-users-to-join-the-app) automatically occur when a user is added to any group for the first time. 

When using the Group API and adding users, invites are sent with a **1-5 minute** delay. This ensures the API response is optimised without waiting for invites to send.

{% hint style="info" %}
You can disable automatic invites by setting the "invite" parameter to "0" for the **groups/insert** & **groups/manage** endpoints.
{% endhint %}

### User Object

When using the **manage** or **insert** endpoints, the **add** or **user** parameter expects a user object. The user object contains required and optional parameters.

| Key          | Type                      |
| ------------ | ------------------------- |
| **REQUIRED** |                           |
| firstname    | String                    |
| lastname     | String                    |
| email        | String (Valid Email)      |
| **OPTIONAL** |                           |
| telephone    | String (e.g +27830001234) |

## Group API Endpoints

### Manage

The **manage** endpoint allows for **managing multiple users in a single group.** This is useful for **bulk user add / remove actions** to a group. 

{% content-ref url="/pages/-MGcvSXVi5OkkV4DEdwQ" %}
[Manage](/falkor-dev-docs/groups/manage.md)
{% endcontent-ref %}

### Status

The **status** endpoint allows for **retrieving multiple user invite status** and allocated groups. This is useful if you wish to track the invite status of users.

{% content-ref url="/pages/-MGcvccNRSXxw3yISngg" %}
[Status](/falkor-dev-docs/groups/status.md)
{% endcontent-ref %}

### Insert

The **insert** endpoint allows for **adding a single user to multiple groups**. This is similar to the **add** parameter for the **manage** endpoint but allows for multiple group assignments.

{% content-ref url="/pages/-MGcvYF5LG7jkI8iAewE" %}
[Insert](/falkor-dev-docs/groups/insert.md)
{% endcontent-ref %}

### Remove

The **remove** endpoint allows for **removing a single user** from multiple groups. This is similar to the remove parameter for the **manage** endpoint but allows for multiple group removals.

{% content-ref url="/pages/-MGcvaLbbAfBSQDSNPRE" %}
[Remove](/falkor-dev-docs/groups/remove.md)
{% endcontent-ref %}