# Inviting users

Every workspace owner can invite any number of users to see and review the available boards. This is particularly powerful to share your features to whoever is the intended target.

***

## Inviting users through the graphic interface

Firstly, click on the top-right account icon and select the `Users` tab.

<figure><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FF9VupPTjujKejF7D9xjt%2Fusrcap.png?alt=media&#x26;token=9bb84f4f-f511-4d06-bc9c-f3c538129959" alt=""><figcaption></figcaption></figure>

Next, input the email of the user you desire to invite and click on `send`.

<figure><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FgKNY62zVwPiwk99OMNh1%2Fusrinvitecap.png?alt=media&#x26;token=8dc43559-a0e4-4419-9aae-b30afa76b0a3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2Fj8QkGq8JSJbzip43UETT%2Finvtsent.png?alt=media&#x26;token=f2b4319b-bf8c-4384-a966-669f1e3b2799" alt=""><figcaption></figcaption></figure>

Finally, the invited user will receive an email like the following

![](https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FkDAvb5LoglWEEHMDSazc%2Fimage.png?alt=media\&token=c6cb35c7-760e-441e-b0bd-c5122202ad5c)

## Inviting users through the SDK

In the SDK, not only users can be invited in the same way, but also newer festures are available. For instance, providing a role to each user to manage access and edition hierarchies on your boards.

***

Defining the roles can be a great start to inviting whoever is desired.

<pre class="language-python"><code class="lang-python"><strong>rol1 = shimoku_client.workspaces.create_role(
</strong>    uuid=workspace_uuid,
    role_name="test_role",
    permission="WRITE", #WRITE/READ
    resource="DATA", #DATA/DATA_EXECUTION/USER_MANAGEMENT/BUSINESS_INFO
    target="USER") #USER/GROUP
</code></pre>

To invite a user, simply use the following command. Incorporate on the parameters the specific roles needed for that user.&#x20;

```python
shimoku_client.workspaces.invite_user(
email = 'jon@gmail.com', 
uuid = workspace_uuid, 
name = workspace_name, 
roles = [rol1])
```

Check the pending invitations using the following code.

```python
shimoku_client.workspaces.get_pending_invitations(
uuid = workspace_uuid, 
name = workspace_name)
```

If it were convenient to delete any pending invitation, use this function.

<pre class="language-python"><code class="lang-python">shimoku_client.workspaces.delete_pending_invitation(
<strong>email = 'jon@gmail.com', 
</strong>uuid = workspace_uuid, 
name = workspace_name)

</code></pre>

Moreover, it is possible to check who is currently invited and it is provided a function to eliminate their access to the content.

```python
shimoku_client.workspaces.get_all_workspace_users(
uuid = workspace_uuid, 
name = workspace_name)

shimoku_client.workspaces.remove_user_from_workspace(
email = 'jon@gmail.com', 
uuid = workspace_uuid, 
name = workspace_name)
```