Create submittal
Submit a candidate to a job with status, rates and notes.
POST https://cotlet.dev/api/v1/jobdiva/jobs/{job_id}/submittals
write Confirm
Creates the submittal and returns its submittal_id. It records the quoted bill rate and the pay rate, and can reach the client, so check list_submittals first to avoid a second submittal for the same person. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id integer required | integer | Job ID from search_jobs or get_job. |
| candidate_id integer required | integer | Candidate ID from search_candidates or find_candidate. |
| status string | string | Submittal status as used in your JobDiva account, for example Submitted. |
| quoted_bill_rate number | number | Bill rate quoted to the client. |
| pay_rate number | number | Pay rate for the candidate. |
| rate_unit string | string | Unit of both rates, for example hour. |
| currency string | string | Currency code of both rates, for example USD. |
| internal_notes string | string | Notes for your own team. |
Request
curl -X POST https://cotlet.dev/api/v1/jobdiva/jobs/24071835/submittals \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"candidate_id":5830117,"status":"Submitted","quoted_bill_rate":105,"pay_rate":90,"rate_unit":"hour","currency":"USD","internal_notes":"Available from 3 Nov, not relocating."}'result = client.call("jobdiva", "create_submittal", {"job_id":24071835,"candidate_id":5830117,"status":"Submitted","quoted_bill_rate":105,"pay_rate":90,"rate_unit":"hour","currency":"USD","internal_notes":"Available from 3 Nov, not relocating."})const result = await cotlet.call('jobdiva', 'create_submittal', {"job_id":24071835,"candidate_id":5830117,"status":"Submitted","quoted_bill_rate":105,"pay_rate":90,"rate_unit":"hour","currency":"USD","internal_notes":"Available from 3 Nov, not relocating."});cotlet call jobdiva create_submittal --data '{"job_id":24071835,"candidate_id":5830117,"status":"Submitted","quoted_bill_rate":105,"pay_rate":90,"rate_unit":"hour","currency":"USD","internal_notes":"Available from 3 Nov, not relocating."}'Example response
{
"submittal_id": 7719203,
"job_id": 24071835,
"candidate_id": 5830117,
"status": "Submitted",
"quoted_bill_rate": 105,
"pay_rate": 90,
"rate_unit": "hour",
"currency": "USD",
"submittal_date": "2026-10-23"
}