Update job status
Update the post-acceptance job status for a lead.
The lead must have been accepted first.
Once status is set to JOB_WON or LEAD_WON, it cannot be changed (contact support to update).
Status-specific required fields:
MEETUP_SCHEDULED:meetingScheduledDaterequiredJOB_WON:jobAmountrequiredJOB_LOST,JOB_POSTPONED_OR_CANCELLED,OTHER:reasonrequired (max 500 chars)LEAD_WON:jobAmount,estimatedProjectStartDate(orstartDateTbd),estimatedCompletionDate(orcompletionDateTbd) required. Attachment soft-required.LEAD_LOST:lostReasonrequired.reasonrequired whenlostReasonisOTHER.REACHED_OUT_TO_HOMEOWNER,MULTIPLE_ATTEMPTS_NO_RESPONSE,CONTACT_MADE,ESTIMATE_PROVIDED: no required fields
Authorizations
JWT token issued from the RenovationFind Manager Portal
Path Parameters
Body
New job status. Required fields vary by status:
MEETUP_SCHEDULED: requiresmeetingScheduledDateJOB_WON: requiresjobAmount(immutable once set)JOB_LOST,JOB_POSTPONED_OR_CANCELLED,OTHER: requiresreasonLEAD_WON: requiresjobAmount, (estimatedProjectStartDateorstartDateTbd), (estimatedCompletionDateorcompletionDateTbd). Immutable once set. Attachment soft-required.LEAD_LOST: requireslostReason.reasonrequired whenlostReasonisOTHER.REACHED_OUT_TO_HOMEOWNER,MULTIPLE_ATTEMPTS_NO_RESPONSE,CONTACT_MADE,ESTIMATE_PROVIDED: no required fields
HOMEOWNER_CONTACTED, MEETUP_SCHEDULED, QUOTE_SENT, JOB_PENDING_DECISION, JOB_WON, JOB_LOST, JOB_POSTPONED_OR_CANCELLED, NO_RESPONSE_FROM_HOMEOWNER, OTHER, REACHED_OUT_TO_HOMEOWNER, MULTIPLE_ATTEMPTS_NO_RESPONSE, CONTACT_MADE, ESTIMATE_PROVIDED, LEAD_WON, LEAD_LOST Notes/reason text. Required for JOB_LOST, JOB_POSTPONED_OR_CANCELLED, OTHER. Required for LEAD_LOST when lostReason is OTHER. Optional for all other statuses.
500Required for MEETUP_SCHEDULED
Required for JOB_WON and LEAD_WON
Optional for REACHED_OUT_TO_HOMEOWNER and CONTACT_MADE
PHONE_CALL, TEXT, EMAIL, IN_PERSON_MEETING Optional for ESTIMATE_PROVIDED
IN_PERSON_ESTIMATE, EMAILED_ESTIMATE, VERBAL_ESTIMATE, PORTAL_ATTACHMENT_ESTIMATE, OTHER Required for LEAD_LOST
PRICE, TIMING, OTHER Required for LEAD_WON (unless startDateTbd is true)
Required for LEAD_WON (unless completionDateTbd is true)
Set to true if project start date is TBD (LEAD_WON)
Set to true if completion date is TBD (LEAD_WON)

