# Make Your First API Call

This guide walks you through authentication, obtaining an access token, and making your very first request against the Quinyx API.

## 1. Get Your API Credentials

Before you can use the API, you need credentials.

Each credential set contains:

* **Client ID** – identifies your integration
* **Client Secret** – private key used for authentication
* **Scopes** – permissions defining what your integration can access


Credentials are generated in **Integrations credentials** page.

To create a new API credential:

1. Log in to Quinyx
2. Navigate to **Account Settings → Integrations credentials**
3. Click **Generate credentials**
4. Choose a name for the credential, select `Version 3`, and click Save.
5. Copy the Client ID and Client Secret (you’ll need these for authentication).
6. Assign the appropriate scopes (permissions) for your integration.


## 2. Authenticate with OAuth 2.0

Quinyx uses the OAuth 2.0 for authentication. You will need to request a bearer token and use it in all subsequent requests.

**Token Endpoint**:


```bash
POST https://api.eu.quinyx.com/oauth/v3/token
```

### Example Request

### Example Response

The `access_token` must be passed in every request to the API using the `Authorization: Bearer` header. Tokens expire after the time defined in `expires_in` (usually 3600 seconds = 1 hour).

## 3. Call Your First API Endpoint

With your token in hand, add it to the `Authorization` header using the **Bearer** scheme.

### Example: List groups

### Example Response

✅ You’ve successfully obtained an access token and called your first Quinyx API endpoint!

## 4. Next Steps

* Browse [other guides](/guides)
* Explore endpoints in the [API Reference](/api)
* Try out requests with your token to start building integrations