> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.studyhq.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.studyhq.com/_mcp/server.

# Enrollment Sync

> Keep StudyHQ updated when a student converts to an enrolled admission on your platform.

StudyHQ maintains a student dashboard that shows whether a student is enrolled or not. This guide explains how to keep that status in sync when a lead converts to an admission on your platform.

---

## Why Sync Enrollment?

When a student who has taken a StudyHQ assessment later converts to an admission in your CRM, StudyHQ can reflect that status on the student's profile. This gives counsellors and institutions a complete view of the student journey — from assessment to enrollment.

---

## Sync Options

There are two ways to keep enrollment status in sync:

### Option 1 — Push via Webhook

When a lead is converted to an admission in your CRM (e.g. status changes to "Admitted" or equivalent), send a status update to the StudyHQ webhook with the student's email.

**Trigger:** CRM lead status changes to enrolled/admitted
**Direction:** Your platform → StudyHQ

This is the recommended approach for real-time accuracy.

### Option 2 — Pull via Scheduled Sync

Expose your leads and admissions API to StudyHQ. StudyHQ will periodically pull updated records and automatically mark students as enrolled based on matching email addresses.

**Trigger:** Scheduled job on StudyHQ's end
**Direction:** StudyHQ pulls from your platform

This option requires sharing API access with StudyHQ during onboarding.

---

## Choosing the Right Option

| Criteria              | Webhook (Push)         | Scheduled Pull               |
| --------------------- | ---------------------- | ---------------------------- |
| Real-time updates     | Yes                    | No (depends on schedule)     |
| Implementation effort | Low (one webhook call) | Medium (API access setup)    |
| Recommended for       | CRMs with event hooks  | Platforms with batch exports |

---

## Getting Set Up

Enrollment sync is configured during onboarding. To enable it:

1. Decide on your preferred sync method (push or pull)
2. Contact [support@studyhq.com](mailto:support@studyhq.com) with your preferred approach
3. StudyHQ will provide the webhook endpoint (for Option 1) or share the sync configuration (for Option 2)

> **Note**
>
> Enrollment sync is optional. Assessment generation and result retrieval work independently of enrollment status.