Hasura
Overview
The Hasura connector lets you connect to a Hasura GraphQL Engine instance.
At this time, the connector supports credential validation (testing connectivity to your Hasura endpoint using the Admin Secret). Loading data into Hasura is still in development and is not yet available.
Setup
Prerequisites
- A reachable Hasura GraphQL Engine endpoint over HTTPS
- A Hasura Admin Secret with permission to execute GraphQL queries
Network access
Ensure the service running this connector can reach your Hasura instance over HTTPS (port 443, or your configured HTTPS port).
Authentication
This connector authenticates using the Hasura Admin Secret header:
- Header:
x-hasura-admin-secret: <admin_secret>
During credential validation, the connector sends a simple GraphQL request to:
POST https://<your-hasura-host>/v1/graphql
with the query:
query { __typename }
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
url | string | ✅ | Base URL for your Hasura instance. Must be a valid HTTPS URL with a host. If you provide a host without a scheme, https:// is assumed. The connector will call the GraphQL endpoint at /v1/graphql. |
admin_secret | string | ✅ | Hasura Admin Secret used to authenticate requests via the x-hasura-admin-secret header. |
URL requirements and examples
- Must be HTTPS and include a host.
- Trailing slashes are allowed.
Examples:
https://hasura.example.comhasura.example.com(treated ashttps://hasura.example.com)
Streams
This connector is a destination. Stream syncing/loading is not yet implemented for Hasura.
Limitations
- Data loading is not available yet: the connector will not write records to Hasura.
- Only HTTPS endpoints are supported.