# Quick Start

{% hint style="danger" %}
**Important Note!**\
\
Constructor Groups’ XAPI V1 has been retired and is no longer available to new customers. Please use the Groups V2 API going forward.\
\
Link to V2 API documentation: <https://developer.perculus.com/v2-en>
{% endhint %}

* [Creating an Account](#creating-an-account)
* [Creating an API User](#creating-api-user)
* [Authorization](#authorization)
* [First Request](#first-request)

### Creating an Account

Firstly, you need to open an account on [Perculus](https://perculus.com). If you have an account, you can skip this step.

{% hint style="warning" %}
We will name the ‘Account Title’ field in your account settings as a domain in the document, and it is essential to note this field as we will use it when sending requests.
{% endhint %}

<figure><img src="https://4016223279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPrQpx3eau0f4PguooXLv%2Fuploads%2FtogExBdZ8rIh84K8VPnz%2FCleanShot%202024-08-16%20at%2013.07.09.png?alt=media&#x26;token=ca3f4ea1-c8b8-497b-a030-57e554ca4567" alt=""><figcaption></figcaption></figure>

### Creating API User

To use the Groups API, you need to create an API user. You can follow the steps below for this process;

1. **Login to your** Groups **account from** [**here**](https://perculus.com/login)

<figure><img src="https://4016223279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPrQpx3eau0f4PguooXLv%2Fuploads%2Fim4Fr4g09X0BgUhTQKiZ%2FCleanShot%202024-08-16%20at%2013.10.38.png?alt=media&#x26;token=74f1475b-d676-4aab-8e91-49547cb86c33" alt=""><figcaption></figcaption></figure>

1. **After logging in, click on the ‘New User’ button in the ‘Users’ section to open the new user creation screen.**<br>

   <figure><img src="https://4016223279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPrQpx3eau0f4PguooXLv%2Fuploads%2FJA9mSdYl0Ta3FvigQ7lG%2FCleanShot%202024-08-16%20at%2013.13.48.png?alt=media&#x26;token=670fd97b-47fb-46b4-a871-df71c9d1cef2" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
At this stage, we will use the information you will write in the email and password fields in the user creation form when sending requests to the API. Therefore, remember that this user **should not be deleted.**
{% endhint %}

### Authorization

Please follow steps that is in [Authorization](https://developer.perculus.com/services/authorization) section.

### First Request  :rocket:

We have outlined all the steps necessary to make your first request to GroupsAPI above. You are now ready to make your first request.

We will use the CURL method to make a request. We will illustrate this with the `/session` endpoint where you can list all your sessions on the system.

Requirements

* Domain
* Access Token

For our example service, session list, you can now see the CURL structure:

```bash
curl --location 'https://<DOMAIN>/xapi/session' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```

You can list all your sessions in the response when you send the sample request above.

It's that easy to send requests in Groups.  :rocket:&#x20;