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. Pass the job ID, resume URL, and job description. Nova loads criteria automatically and uses the job description for scoring context.Integration Flow
Generate Criteria
Call the criteria generation endpoint with your job description - criteria are stored automatically
Score Candidates
Submit candidates for scoring as applications come in with job ID, application ID, resume URL, and job description
Base URLs
| Service | URL |
|---|---|
| API | https://embed.nova.dweet.com/v1 |
| Portal | https://embed.nova.dweet.com |
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.