---
title: GraphQL
description: Learn how to connect and configure GraphQL connections in Infoveave to retrieve data from GraphQL servers for reporting and dashboards.
---

import { Steps } from '@astrojs/starlight/components';

# GraphQL

GraphQL connection helps Infoveave connect to a GraphQL data server, authenticate securely, and query structured data efficiently.

## Adding a GraphQL Connection

To create a new GraphQL connection:

<Steps>
1. Go to **Administration** > **Connections**
2. Click **New Connection** and select **GraphQL** from the available connectors
3. In the **New GraphQL Connection** form, provide the required configuration details
</Steps>

## Connection Parameters

When setting up a GraphQL connection, you need to provide the following details:

| Field | Description |
|-------|-------------|
| **Name** | A unique name to identify your GraphQL connection |
| **Auth Request Type** | The authentication method type (e.g., GET or POST) |
| **Auth URL** | The authentication endpoint URL for your GraphQL server |
| **Client ID** | Your application's client identifier for authentication |
| **Client Secret** | Your application's secret key for authentication |

## Authentication Configuration

Configure how Infoveave should authenticate with your GraphQL server:

- **Add Auth Headers**: Include authentication tokens or custom headers in the request  
- **Add Auth Form Data**: Send authentication credentials as form data

## Steps to Validate and Save

<Steps>
1. After configuring your GraphQL connection parameters, click **Validate** to verify the connection
2. If validation succeeds, click **Save** to store the connection
3. You can now use this GraphQL connection as a datasource in your Infoveave workflows and visualizations
</Steps>

## Example Use Cases

With a GraphQL connection configured, you can:

- Query structured data using GraphQL schemas and resolvers  
- Retrieve nested, relational, or aggregated data from GraphQL APIs  
- Build dashboards powered by customizable GraphQL queries  
- Combine GraphQL data with other Datasources for unified reporting  
- Automate workflows based on GraphQL data  
- Connect to headless CMS systems for content analytics