---
title: "Check if Agent Already Exists in Boost"
method: POST
path: "/graphql"
tags: ["Boost V2 Integration", "GraphQL"]
---

# Check if Agent Already Exists in Boost

`POST /graphql`

## Request

- Base URL: `https://boost.homespotter.com`
- URL: `https://boost.homespotter.com/graphql`
- Auth: HTTP bearer

Verify whether an agent has already been linked to a Boost account using GraphQL queries.
This endpoint is part of Boost Integration V2 and uses a separate GraphQL API secret token
(not the same as the JWT token used for other V2 endpoints).
Use this to determine if an agent needs to be created or if they have an existing account.

## Request body

- object
  - `query` string: GraphQL query
  - `variables` object: Query variables

## Response `200`

GraphQL query executed successfully

- AgentQueryResponse
  - `data` object
    - `agents` object
      - `totalCount` integer
      - `list` AgentInfo[]
        - `firstName` string
        - `lastName` string
        - `emailAddress` string, email

## Other responses

- `400`: Invalid GraphQL query
- `401`: Unauthorized - invalid token

---

[API](https://skmtc.dev/lwolf/apis/homespotter-boost-checkout-api.md) · [All operations](https://skmtc.dev/lwolf/apis/homespotter-boost-checkout-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/homespotter-boost-checkout-api/revisions/49abcb2542b6?raw)