Skip to main content

Getting Started

The Hgraph App is where you manage your organizations, projects, API keys, and billing. It includes built-in playgrounds for testing GraphQL and JSON-RPC queries against live Hedera data.

Hgraph App organization overview

Create an account​

Go to app.hgraph.com and sign in using one of three methods:

  • GitHub - click "Continue with GitHub" to authenticate with your GitHub account
  • Google - click "Continue with Google" to authenticate with your Google account
  • Email - enter your email address and click "Send magic link". Check your inbox for a one-time code to complete sign-in.

No passwords are required. If this is your first time signing in, an account is created automatically.

Create your first organization​

After signing in, create an organization. Organizations are the top-level container for everything in the Hgraph App: projects, API keys, teams, and members.

  1. Click Create Organization.
  2. Enter a name and URL slug for your organization.
  3. Click Create.

Your organization dashboard shows an overview of your current plan, projects, API keys, teams, and members.

Create a project​

Projects live inside organizations. Each project has its own set of API keys and usage tracking, so you can separate production, staging, and development environments.

  1. Go to Projects in the sidebar.
  2. Click Create Project.
  3. Enter a name, URL slug, and optional description.
  4. Click Create.

Every Hgraph account includes 1 project on the free tier. Paid plans support additional projects (see pricing).

Get your API key​

Hgraph App API keys page

Each project generates two types of API keys:

  • Publishable Key (pk_prod_) - safe to use in client-side code. Restricted permissions.
  • Secret Key (sk_prod_) - for server-side use only. Full permissions. Never expose this in client-side code or public repositories.

To create an API key:

  1. Go to API Keys in the sidebar.
  2. Click Create API Key.
  3. Select the project for this key.
  4. Optionally add a nickname (e.g., "Production Backend").
  5. Copy your keys and store them securely.

Keys are masked in the UI after creation. You can copy them to your clipboard at any time.

Quick start

With your API key, you're ready to start querying. Try a request using the GraphQL API, REST API, or test queries directly in the built-in playgrounds.

What's next​