Skip to main content

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

FieldTypeRequiredDescription
urlstringBase 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_secretstringHasura 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.com
  • hasura.example.com (treated as https://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.