> For the complete documentation index, see [llms.txt](https://docs-v3.toucantoco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-v3.toucantoco.com/administration/managing-users/inviting-guests.md).

# Inviting guests

As an app administrator either at both the **app store** and **application** level, learn how to add and modify guest.

### Overview

You can create guests who will receive a scheduled PDF report. At present, this is the only privilege that guests have.

To create guest, you have to be an **admin** and do it from the **user interface**.

On this page, you have the guests in rows and the apps of your instance as columns.

At the intersection, a pictogram indicates the guest access has been granted.

More than giving you an overview of your guests’ access, from this interface you can also:

* Search the guests: just start typing the guest’s email
* See the number of guests
* Sort your guests
* Hover on the guest name to get its creation date

<figure><img src="/files/mlB19b1B8EqVDQMYhro6" alt="guest-table"><figcaption></figcaption></figure>

### Create guests

You can create guests from the **Add a guest** button at the top right side of your screen.

<figure><img src="/files/bC8QpgebiombWcxHnO8B" alt="guest-creation-button"><figcaption></figcaption></figure>

#### Create/edit a single guest

**Options**

* **Username** : the username must be an email address
* **User-group(s)** : *(Optional)* assign one or multiple groups to your guest

**Assign guest privilege**

Once you have created your guest, click on **continue** to assign guest privilege to one or multiple apps

<figure><img src="/files/pkb29C0b2Y6SjTholpDx" alt="guest-creation"><figcaption></figcaption></figure>

**Edit guest**

You can edit a guest’s privileges directly from the interface by clicking on the guest privilege icon in a given app column.

<figure><img src="/files/NKqPtJXj7wyeKmMJYru9" alt="guest-privileges"><figcaption></figcaption></figure>

You can edit a guest’s information by selecting a guest from the list to activate the edition menu at the bottom right of your screen.

<figure><img src="/files/xI6dp1HG2ifpSlzPaqGo" alt="guest-edition-bar"><figcaption></figcaption></figure>

#### Create/edit multiple guests

{% hint style="info" %}
**Hint**

This is what we call bulk creation 👥
{% endhint %}

**Bulk creation/edition template**

To create multiple guests, you need to drop a csv file that contains specific information.

<figure><img src="/files/7vBU0Y3TuIzsCuIz7zio" alt="guest-bulk-creation"><figcaption></figcaption></figure>

A template file is available for download. This file contains all the required columns you need to fill:

* **username** : the username must be an email address
* **user-group** : *(Optional)* type in the name of the group, leave it empty if you don’t want to assign any group to your guest(s). There are by default 3 user-group column, but you can add more just make sure to update the number after `user-group`
* All existing app on your store will have a dedicated column (`small-app lovely-name`), you just need to fill the `guest` privilege for each app.

{% hint style="info" %}
**Hint**

If you want to delete some guests with a bulk upload, then add a `delete` columns and fill it with `true` or `false`
{% endhint %}

Once you’re done filling-up the template, you just have to drop it in the tile 🎉.

### Request Access

A guest can request an access to Toucan Toco from the login screen.

<figure><img src="/files/F02PLs34J2s5jBUFD1Tn" alt="guest-request-access"><figcaption></figcaption></figure>

All platform admins will receive an email requesting access.

If a guest is converted to a user, they will be automatically transformed as real user.

Request access emails can only be sent once a day to the same admin for the same user. Admins can unsubscribe from these notifications.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs-v3.toucantoco.com/administration/managing-users/inviting-guests.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
