Integrations Soon

Integrations allow you to automate your client generation workflow. Create dependency links between your clients and APIs, and watch the magic unfold. While we prefer to use openapi-ts for generating clients, you can use any codegen.

Upload OpenAPI Spec

First, you need to configure your API services to send us OpenAPI specifications. This can be done by adding our hey-api/upload-openapi-spec GitHub Action into your CI workflow.

name: Upload OpenAPI Specification

on:
  push:
    branches:
      - main

jobs:
  upload-openapi-spec:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Upload OpenAPI spec
        uses: hey-api/upload-openapi-spec@v1
        with:
          hey-api-token: ${{ secrets.HEY_API_TOKEN }}
          path-to-openapi: path/to/openapi.json

This step requires you to register with us in order to obtain a Hey API token. Please follow the instructions in our GitHub Action to complete the setup. Once you have your APIs configured, you're ready to connect your clients.

Configure Clients

More information will be provided as we finalize the tooling.