What the Embed API Does
Generate Screening Criteria
Automatically extract screening criteria from job descriptions with appropriate importance levels
Score Candidates
Candidate assessment against your criteria with detailed reasoning
Structured Insights
Receive scores, strengths, concerns, and interview focus areas for each candidate
Webhook Delivery
Asynchronous scoring with results delivered via webhook or polling
Key Concepts
| Concept | Description |
|---|---|
| Integrator | Your organization. Billing happens at the integrator level. |
| Tenant | One of your customers. Used for data isolation and per-customer metrics. |
| Environment | Sandbox (testing) or Production (live). Separate API keys per environment. |
How It Works
The integration has two main phases:1. Job Setup (Once per job)
Generate screening criteria from the job description. Optionally, collect answers to clarification questions to refine the criteria. Criteria are stored by Nova automatically.2. Scoring (Per applicant)
Submit candidate resumes for async scoring - just pass the job ID and resume. Nova loads criteria automatically.Integration Flow
1
Get API Keys
Obtain sandbox and production API keys from the Embed Portal
2
Generate Criteria
Call the criteria generation endpoint with your job description - criteria are stored automatically
3
Score Candidates
Submit candidates for scoring as applications come in - just job ID, application ID, and resume
4
Receive Results
Process webhook callbacks with scores and assessments
Base URLs
| Service | URL |
|---|---|
| API | https://embed.nova.dweet.com/v1 |
| Dashboard | https://embed.nova.dweet.com/dashboard |
Environments
The environment is determined by your API key prefix—not the URL:| API Key | Environment | Billing |
|---|---|---|
sk_test_* | Sandbox | Free, not billed |
sk_live_* | Production | Billed per score |
Sandbox uses the same AI models and processing pipeline as production. Scores generated in sandbox are representative of production quality.