Getting Started: 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 set.
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:

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

Example Request

curl -X POST "https://api.eu.quinyx.com/oauth/v3/token?grant_type=client_credentials" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"

Example Response

{
  "expires_in": 3599,
  "jti": "ddbcd0a5-8197-4653-9664-248eb48ce8d1",
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6...",
  "scope": "read write",
  "token_type": "bearer"
}

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

curl -X GET "https://api.eu.quinyx.com/organization/groups" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example Response

GET /organization/v3/groups
Host: api.eu.quinyx.com
Content-Type: application/json

{
  "data": [
    {
      "id": "1",
      "name": "My district",
      "groupType": "DISTRICT",
      "managerId": "87",
      "xrefIds": [
        "my_external_id_10"
      ],
      "created": "2025-01-01T12:00:00Z",
      "updated": "2025-01-01T12:00:00Z"
    },
    {
      "id": "2",
      "groupType": "UNIT",
      "name": "My unit",
      "parentGroupId": "1",
      "managerId": "87",
      "costCentreId": "1",
      "xrefIds": [
        "my_external_id_11"
      ],
      "created": "2025-01-01T12:00:00Z",
      "updated": "2025-01-01T12:00:00Z"
    },
    {
      "id": "3",
      "groupType": "SECTION",
      "name": "My section",
      "parentGroupId": "2",
      "managerId": "87",
      "costCentreId": "1",
      "xrefIds": [
        "my_external_id_12"
      ],
      "created": "2025-01-01T12:00:00Z",
      "updated": "2025-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "nextPageToken": "cHJldmlvdXNUb2tlbg"
  }
}

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

4. Next Steps

• Browse other guides
• Explore endpoints in the API Reference
• Try out requests with your token to start building integrations