Great Question API

Name: Great Question API
Brand: Great Question API
Availability: InStock

✓ Official Vendor SpecProductivityForms Surveysbearer21 EndpointsREST

For Agents

Manage research candidates, run bulk panel imports, and operate UX research studies and sessions in Great Question.

Connect the Great Question API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Great Question API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Great Question API.

Look up the authenticated workspace account and list available accounts

Create, retrieve, and unsubscribe individual research candidates via /v1/candidates

Run bulk imports and deletions across the candidate panel via /v1/candidates/bulk endpoints

Record and retrieve consent form submissions for a candidate

GET STARTED

Start building with Great Question API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Great Question API for, with concrete tasks.

★ Panel Synchronisation from a CRM

Customer research teams use the bulk candidate endpoints to keep their Great Question panel in sync with the source-of-truth CRM, adding new customers and removing churned ones on a schedule. The bulk import endpoint accepts a list of candidates with custom attributes so segmentation rules in studies stay accurate.

POST 500 candidates with company and plan attributes to /v1/candidates/bulk and confirm the response shows zero errors

Consent Logging for Research Studies

Research operations teams use the consent forms endpoint on candidates to retrieve evidence that a participant agreed to recording, data retention, or compensation terms before a session takes place. The API surfaces the consent form record so it can be stored alongside session artifacts.

GET /v1/candidates/{candidate_id}/consent_forms and store each consent record in the team's research drive

Study Participant Tracking

Research managers use the Studies and Study Participants endpoints to monitor recruiting progress for an active study, see which candidates accepted or completed sessions, and trigger follow-up outreach for no-shows.

List study participants for the active study and email a follow-up to anyone whose status is 'invited' but not 'scheduled'

Agent-Driven Research Operations Assistant via Jentic

An AI research operations assistant uses Jentic to discover the right Great Question operation when a researcher asks 'add this customer to the panel' or 'who's signed up for the pricing study?'. Jentic injects the bearer token from the vault and the agent works with structured Great Question data.

Search Jentic for 'add a candidate to great question', load the schema, and execute /v1/candidates with the user's lead details

Key Endpoints

21 endpoints — the great question api exposes the core resources of a great question ux research workspace — accounts, candidates, custom attributes, sessions, studies, and study participants — across 21 endpoints.

METHOD

PATH

DESCRIPTION

GET

/v1/account

Retrieve the authenticated account

GET

/v1/candidates

List research candidates

POST

/v1/candidates

Create a research candidate

POST

/v1/candidates/bulk

Bulk import candidates

POST

/v1/candidates/bulk/delete

Bulk delete candidates

POST

/v1/candidates/unsubscribe

Unsubscribe a candidate from outreach

GET

/v1/candidates/{candidate_id}/consent_forms

Retrieve a candidate's consent forms

GET

/v1/account

Retrieve the authenticated account

GET

/v1/candidates

List research candidates

POST

/v1/candidates

Create a research candidate

POST

/v1/candidates/bulk

Bulk import candidates

POST

/v1/candidates/bulk/delete

Bulk delete candidates

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Great Question bearer tokens are stored encrypted in the Jentic vault and added to the Authorization header at execution time. The agent never sees the raw token in its prompt or response.

Intent-based discovery

Agents search Jentic by intent (e.g., 'add a candidate in great question') and Jentic returns the matching operation with its parameter schema, so the agent can call /v1/candidates or /v1/candidates/bulk directly.

Time to first call

Direct Great Question integration: half a day to wire bearer auth, pagination, and bulk error handling. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Great Question API through Jentic.

What authentication does the Great Question API use?

The API uses HTTP bearer authentication. Generate a token from the Great Question workspace settings and pass it in the Authorization header on every request. Through Jentic the bearer token is held in the encrypted vault and injected per call so the agent never holds the raw token.

Can I bulk import candidates into Great Question?

Yes. POST a list of candidate objects to /v1/candidates/bulk with email, name, and custom attribute fields. The response indicates per-row success or error so the caller can retry only the failed rows. There is also a /v1/candidates/bulk/delete endpoint for bulk removal.

What are the rate limits for the Great Question API?

Great Question does not publish a fixed numerical limit and recommends backing off on HTTP 429 responses. For panel sync workloads, prefer the /v1/candidates/bulk endpoints over per-row calls and run on a schedule rather than continuously. Jentic surfaces 429 responses to the agent so it can wait before retrying.

How do I add a new candidate through Jentic?

Search Jentic for 'add a candidate in great question', load the operation that maps to POST /v1/candidates, and execute it with the candidate's email, name, and any custom attributes. The response includes the new candidate id which can then be used in study-candidate assignments.

Can I retrieve a candidate's signed consent forms?

Yes. GET /v1/candidates/{candidate_id}/consent_forms returns the consent records linked to that candidate, which can be archived alongside session recordings for compliance. The endpoint is scoped to the authenticated account so it only returns consent forms for candidates in your workspace.

Does this API support managing studies, not just candidates?

Yes. The Studies, Study Candidates, and Study Participants tags expose endpoints for inspecting studies and the candidates assigned to them. Combined with the Candidates surface, an agent can operate the full recruiting lifecycle from importing a candidate to tracking session completion.

Great Question API

Connect the Great Question API to your agent

Capabilities

Start building with Great Question API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs