# Webhooks and API

> Send results to your HR system, Zapier or Make the second someone submits. Signed webhooks with retries, plus an API for quizzes, attempts, invites and codes.

URL: https://office.greatwork.company/quiz/features/webhooks-and-api
Last updated: 2026-11-21

Signed webhooks for every attempt and certificate, plus an API to read results and create invites and codes. On every plan.

## Webhooks

Pick the events and a URL, and Quiz sends a signed POST when they happen: `quiz.attempt.started`, `quiz.attempt.submitted`, `quiz.attempt.graded`, `quiz.attempt.passed`, `quiz.attempt.failed`, `quiz.certificate.issued`, `quiz.invite.sent` and `quiz.quiz.published`. The payload has the quiz, the attempt summary, the taker's fields and, if you want, every answer. A delivery log shows each send, and failed sends are retried.

Zapier, Make and n8n can all catch a webhook, so you can send results to a spreadsheet, your HR system or a chat channel without waiting for an app. Native Slack and Google Sheets connections are coming soon.

## API

Create an API key with read or read and write access. List quizzes, read attempts with their answers (filter by quiz, status, email or date), send invites, add or remove access codes, and look up a certificate by serial.

## Example: Training records that update themselves

A home care agency keeps staff training records in its HR system. A webhook on `quiz.attempt.passed` posts to the HR system's endpoint with the employee ID (collected as a start-form field), the quiz name, the score and the certificate serial. Nobody types training records by hand any more, and a failed delivery during the HR system's maintenance window is retried automatically.

## How to set it up

1. Open **Settings**, then **Webhooks**, and add your endpoint URL.
2. Choose the quiz events to send.
3. Copy the signing secret and check signatures on your side.
4. For the API, create a key under workspace settings.

---

Office by Great Work. Questions or corrections: hello@greatwork.company
