# 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 %}


---

# 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://everyday-digital.gitbook.io/falkor-dev-docs/groups/concepts.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.