> ## Documentation Index
> Fetch the complete documentation index at: https://hireflixsl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Hireflix with Claude

## What is this?

Hireflix publishes a **skill file** at [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md). It contains everything an **AI (we use Claude in this example)** needs to talk to the Hireflix API directly — the GraphQL schema and example queries — so that once you provide your API key, you can ask Claude questions about your account in plain English instead of writing GraphQL yourself.

<Note>
  You'll need a Hireflix **API key** to use the skill. If you don't have one yet, follow the [Quickstart](/tech/quickstart) to create an account and generate a key.
</Note>

<Warning>
  You must allow network access to `api.hireflix.com` **before** you start the chat session that will use this skill.
</Warning>

## Setup

<Steps>
  <Step title="Allow api.hireflix.com in your network egress settings">
    In Claude, go to **Settings → Capabilities**, scroll all the way down to the **Allow network egress** section, and enable the domain allowlist. Add `api.hireflix.com` to the list. Do this before you start a new chat.

    <img src="https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=bcbe11ba17dc0b1fa161c2bc56e6671e" alt="Enabling the domain allowlist and adding api.hireflix.com under Settings > Capabilities > Allow network egress" data-og-width="1898" width="1898" data-og-height="968" height="968" data-path="images/hireflix-userguide-claude-network-egress.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?w=280&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=8b224192c937069a6be03272386b17d1 280w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?w=560&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=bb147b6a9bd15179f51df3a552f65c1b 560w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?w=840&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=6a37df8673f2625db8added2c1f104f3 840w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?w=1100&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=3502e797e5157ccd7c44002e2fc6fb42 1100w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?w=1650&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=7218676ef9cb0601c68af853891bc41d 1650w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-network-egress.png?w=2500&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=dc938a4a2d1b73eaa71b8dcaddd1cbe9 2500w" />
  </Step>

  <Step title="Get the Hireflix skill file">
    Open [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md) and save the page as `skill.md`. You can hit `CTRL + S` or on Mac `CMD + S` to store the page as `skill.md` on your machine.
  </Step>

  <Step title="Upload the skill to Claude">
    Still under **Settings → Skills**, upload the `skill.md` file you just saved by clicking the "Add" button and selecting "Upload a skill".

    <img src="https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=85e0ad8fce0ecf8530f1db6a80ce4e4e" alt="Uploading skill.md as a custom skill under Settings > Capabilities" data-og-width="1898" width="1898" data-og-height="702" height="702" data-path="images/hireflix-userguide-claude-skill-upload.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?w=280&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=0d9c80566cd093e2c77e21abdb5fc56e 280w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?w=560&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=268e8243cdc747cbf4be92c75ad89e2a 560w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?w=840&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=95be2da6481dec8398dfb9161d1782b0 840w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?w=1100&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=7f3a4e97004ab07dda77c7c8a8d78ff8 1100w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?w=1650&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=0b3b3e27c4eff19b7b7ed2e272e720da 1650w, https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-upload.png?w=2500&fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=e53e3a59fe886e4749ec33f1e0d232cb 2500w" />
  </Step>

  <Step title="Start a new chat and add your API key">
    Start a **new** chat (so the network egress rule from step 1 applies), and give Claude your Hireflix API key so it can authenticate against `api.hireflix.com`. See the [Quickstart](/tech/quickstart) if you still need to create one.

    <Warning>
      When sharing an API key with Claude AI, make sure to revoke it after your session has ended as a safety precaution.
    </Warning>
  </Step>
</Steps>

## Try it out

Once your API key is set for the session, try asking Claude things like:

* "Can you help me list all positions for Hireflix in my account?"
* "Can you pull interview stats (per stage) for each of the positions (total, pending, to evaluate, shortlisted, and discarded)?"
* "Can you give me an overview of the questions and answers for the following completed interview for position `<your-position-id>`?"

Claude will use the schema and examples from the skill file to write and run the right GraphQL queries against your account behind the scenes.

<Frame caption="Claude's response after being asked to list all positions">
  <img src="https://mintcdn.com/hireflixsl/Ypm7QQvPzDIYtdD0/images/hireflix-userguide-claude-skill-demo.png?fit=max&auto=format&n=Ypm7QQvPzDIYtdD0&q=85&s=c033fa0bd83e84c562e38f5eab5fad86" alt="Example Claude conversation using the Hireflix skill to list positions and interview stats" width="1512" height="594" data-path="images/hireflix-userguide-claude-skill-demo.png" />
</Frame>

## What's next?

<CardGroup cols={2}>
  <Card title="GraphQL Basics" icon="graduation-cap" href="/tech/graphql-basics">
    Understand the queries and mutations Claude is running on your behalf.
  </Card>

  <Card title="Interview Management" icon="microphone-lines" href="/tech/features/overview#interview-flow">
    Explore the full interview flow: from inviting candidates to reviewing completed interviews.
  </Card>
</CardGroup>
