1. Overview

Connect JobDiva candidate, job, and placement data to 1099Policy so contractor engagements can be insured or validated before work begins.

You can:

• Bind fractional, on-demand coverage for contractor placements.
• Automatically validate or upload Certificates of Insurance (COIs).
• Keep compliance in sync through 1099Policy webhooks (policy.*, certificate.*).
• Map JobDiva placement compensation to job.wage and wage_type.
• Store JobDiva IDs in custom_metadata for reconciliation.

2. Integration Timing & Trigger

Coverage should begin when a contractor placement is created, confirmed, or updated with start-date and compensation details. In JobDiva, the Placement is the best trigger because it connects the Candidate to the Job and usually contains or references assignment dates, pay terms, and client/worksite information.

• Primary trigger: Contractor placement created or confirmed.
• Alternative triggers: Candidate submitted to job, placement updated, assignment start date confirmed, timesheet created, invoice created.
• Event delivery: JobDiva webhooks where available; otherwise poll candidate, job, placement, timesheet, and invoice methods.
• Required data: candidateId, jobId, placementId, start date, end date, compensation amount, compensation type, and work region.

3. Core Concepts

Each JobDiva object maps to a corresponding 1099Policy resource so contractor coverage, COI validation, and audit trails stay aligned.

4. End-to-End Implementation

Follow these steps to integrate JobDiva and 1099Policy for contractor insurance workflows.

4.1 Retrieve Candidate

Retrieve the JobDiva Candidate and create or upsert the corresponding 1099Policy Contractor. Every Contractor must include a unique email address. Generate a proxy if JobDiva does not expose one, such as <candidate_id>@relay.yourdomain.com.

Source: JobDiva

Use the JobDiva V2 Candidate methods to retrieve the candidate profile, contact information, and address fields needed to create a 1099Policy Contractor.

JobDiva V2 API Method Family: Candidate
Suggested operation: Get Candidate / Candidate Details
Required identifier: candidateId

Destination: 1099Policy (POST /contractors)

POST https://api.1099policy.com/api/v1/contractors
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: application/json
Idempotency-Key: jobdiva-candidate-<candidateId>

{
  "contact": {
    "first_name": "Jordan",
    "last_name": "Lee",
    "email": "candidate_12345@relay.yourdomain.com"
  },
  "address": {
    "country": "US",
    "region": "CA"
  },
  "custom_metadata": {
    "jobdiva_candidate_id": "12345"
  }
}

4.2 Retrieve Job

Retrieve the JobDiva Job or Requisition and create the corresponding 1099Policy Job. The Job captures the role, category, description, work region, and estimated compensation used to price coverage.

Source: JobDiva

Use the JobDiva V2 Job methods to retrieve job or requisition details. If compensation is not available on the Job object, retrieve the Placement before creating the 1099Policy Job so the wage and wage_type are accurate.

JobDiva V2 API Method Family: Job
Suggested operation: Get Job / Job Details
Required identifier: jobId

Destination: 1099Policy (POST /jobs)

POST https://api.1099policy.com/api/v1/jobs
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: application/json

{
  "name": "Contract Data Analyst — Client Project",
  "description": "Three-month analytics engagement supporting reporting migration.",
  "entity": "en_12AbC3",
  "category_code": "DATA_ANALYTICS",
  "wage": 9500,
  "wage_type": "hourly",
  "region": "CA",
  "custom_metadata": {
    "jobdiva_job_id": "job_78910",
    "jobdiva_candidate_id": "12345"
  }
}

4.3 Retrieve Placement

Retrieve the Placement to create a Quote. The Placement is the canonical JobDiva object for coverage because it ties the Candidate to the Job and usually contains the engagement dates, compensation basis, and client/worksite context.

Source: JobDiva

Use the JobDiva V2 Placement or Assignment methods to retrieve placement-level details. If your tenant uses a different label for placed candidates or assignments, map the object that establishes the Candidate ↔ Job relationship.

JobDiva V2 API Method Family: Placement / Assignment
Suggested operation: Get Placement / Placement Details
Required identifier: placementId

Destination: 1099Policy (POST /quotes)

POST https://api.1099policy.com/api/v1/quotes
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: application/json

{
  "contractor": "cn_Kh18Qs",
  "job": "jb_Dl9n42",
  "coverage_type": ["general","workers-comp"],
  "effective_date": 1764300000,
  "end_date": 1766892000,
  "custom_metadata": {
    "jobdiva_placement_id": "pl_45678",
    "jobdiva_job_id": "job_78910",
    "jobdiva_candidate_id": "12345"
  }
}

4.4 Create Insurance Application Session

Redirect contractors to complete their first policy opt-in and bind coverage before the placement begins. This step only applies to contractors who are purchasing or activating coverage through 1099Policy for the first time.

Destination: 1099Policy (POST /apply/sessions)

POST https://api.1099policy.com/api/v1/apply/sessions
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: application/json

{
  "quote": "qt_Pf5LmA",
  "success_url": "https://dashboard.yourdomain.com/jobdiva/placements/pl_45678?coverage=active",
  "cancel_url": "https://dashboard.yourdomain.com/jobdiva/placements/pl_45678?coverage=canceled",
  "custom_metadata": {
    "jobdiva_placement_id": "pl_45678"
  }
}

4.5 Create Assignment

Create an Assignment for returning contractors who have already completed the initial opt-in. The Assignment should use the same Job and Contractor created from the Candidate, Job, and Placement data.

Source: JobDiva

Use the same Placement / Assignment data used to create the Quote.

JobDiva V2 API Method Family: Placement / Assignment
Suggested operation: Get Placement / Placement Details
Required identifier: placementId

Destination: 1099Policy (POST /assignments)

POST https://api.1099policy.com/api/v1/assignments
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: application/json

{
  "contractor": "cn_Kh18Qs",
  "job": "jb_Dl9n42",
  "effective_date": 1764300000,
  "end_date": 1766892000,
  "coverage_type": ["general","workers-comp"],
  "custom_metadata": {
    "jobdiva_placement_id": "pl_45678"
  }
}

4.6 Upload Certificate (BYO-COI)

This independent workflow supports contractors who already have their own insurance. Upload the COI to 1099Policy for validation and tracking. Depending on your JobDiva configuration and licensed API modules, candidate attachments may or may not be available through the API. If your integration cannot retrieve the COI document directly from JobDiva, collect it through your own intake flow or request it from the contractor.

Source: JobDiva

Use candidate attachment or document methods if enabled for your JobDiva tenant.

JobDiva V2 API Method Family: Candidate Attachment / Document
Suggested operation: Get Candidate Attachment / Download Document, if enabled
Required identifier: candidateId or attachmentId

Destination: 1099Policy (POST /files/certificates)

POST https://api.1099policy.com/api/v1/files/certificates
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: multipart/form-data

Form fields:

• certificate=@file.pdf
• contractor=cn_Kh18Qs
• custom_metadata[jobdiva_candidate_id]=12345
• custom_metadata[jobdiva_placement_id]=pl_45678

4.7 Record Invoice (Optional)

If the contractor’s actual pay differs from the original placement estimate, record final remuneration using the Invoice API. This step is optional and does not affect coverage.

Source: JobDiva

Use timesheet, invoice, or placement payroll detail methods if enabled for your JobDiva account.

JobDiva V2 API Method Family: Timesheet / Invoice / Placement Payroll Detail
Suggested operation: Get Timesheet / Get Invoice / Get Pay Detail
Required identifier: timesheetId, invoiceId, or placementId

Destination: 1099Policy (POST /invoices)

POST https://api.1099policy.com/api/v1/invoices
Authorization: Bearer YOUR_1099POLICY_TOKEN
Content-Type: application/json

{
  "contractor": "cn_ti8eXviE4A",
  "job": "jb_rajdrwMUKi",
  "gross_pay": 1200,
  "paycycle_startdate": 1714419793,
  "paycycle_enddate": 1714419793
}

5. Webhooks

JobDiva webhooks should be used where available to react to candidate, job, placement, document, timesheet, or invoice changes. Pair JobDiva events with 1099Policy events so your compliance view stays current.

6. Testing Checklist

Run this checklist end-to-end using a test Candidate, Job, and Placement before moving to production.

• Candidate exists in 1099Policy as a Contractor with valid or proxy email.
• Job created with accurate compensation, wage_type, region, and JobDiva metadata.
• Quote created with coverage types and placement dates.
• Application Session redirects and completes successfully.
• Assignment aligns with placement start and end dates.
• BYO-COI path tested independently from fractional coverage.
• Optional invoice recorded when final remuneration differs.
• Webhook handlers are idempotent and retry-safe.
• Only contractor placements flow through this integration.

7. References

• JobDiva API Management: https://next.jobdiva.com/api-management/updates
• JobDiva integration sandbox: https://www.jobdiva.com/sandbox
• 1099Policy API Docs: https://www.1099policy.com/docs