Placements
Imports one JobDiva placement as a Bilflo contract job. DRY RUN BY DEFAULT. Pass dryRun=false to write. That direction is deliberate: this is the first write path into a live customer account, there is no staging environment, Bilflo has no duplicate guard on jobs, and a contract job cannot be deleted - only deactivated. So a caller has to ask for the write rather than remember to ask for safety. A dry run reports exactly what the job would be built from and every reason it cannot be created yet. It refuses rather than filling a gap with a default: a guessed pay rate bills wrongly and a guessed W2-versus-1099 is a tax problem, so "no job" is the better failure.
Changed onpost/jobdiva/v1/placements/import
Request
- Base URLhttps://api.bilflo.com (the document declares no server; this is the origin it was published from)
- URLhttps://api.bilflo.com/jobdiva/v1/placements/import
- AuthAPI key in header Authorization
Query parameters
companyIntegrationIdstring uuid
placementIdstring
dryRunboolean
Headers
company-idstring required
Response
Success
Changes
- info
added the new optional
queryrequest parametercompanyIntegrationId - info
added the new optional
queryrequest parameterdryRun - info
added the new optional
queryrequest parameterplacementId
- info
- info
endpoint added
- info