Webhooks and events

A developer adds an endpoint with their own sign-in (webhooks.create); the secret is shown once. Deliveries are POSTs with DW-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of t.body>. Any non-2xx is retried with backoff. Delivery is at least once, so dedupe on the event id.

EventWhat happened
shop.createdA shop was created.
membership.invitedA person was invited to a shop.
membership.role_changedA worker's role in a shop changed. The old membership ended and a new one started.
quote.revisedAn unsigned quote was replaced by a new version.
quote.withdrawnThe shop took back an unsigned quote; its signing links stopped working.
charge.succeededA payment succeeded.
dispute.closedA payment dispute closed (won, lost or closed).
plan.changedA shop changed plan.
subcontractor_list.signedA shop signed the Idaho 45-525(3) subcontractor list for a job.
subcontractor_list.preparedAn agent prepared the Idaho 45-525(3) subcontractor list for a person to sign.
plan.change_scheduledA shop scheduled a move down; it starts on the first day of effective_period (shop time).
fee.owed_to_shopA fee that was credited against a plan price is owed back to the shop after a refund or lost dispute.
plan.billedNot sent. Doing Work has no plans or monthly fee; kept so old subscriptions stay valid.
membership.startedA person joined a shop.
membership.endedA person's membership in a shop ended.
membership.permissions_changedThe owner changed what a worker may do: see_prices, see_costs, take_money, delete and manage_schedule.
ownership.transfer_startedThe owner started handing the shop to someone else.
ownership.transferredShop ownership moved to a new owner.
ownership.transfer_cancelledAn open hand-off was stopped: the owner cancelled it or the person asked declined.
shop.closedThe owner closed the shop. Everyone lost access and every link stopped; records are kept.
job_subcontractor.addedA subcontractor was added to a job.
job_subcontractor.updatedA subcontractor's contact name, trade or scope note changed.
job_subcontractor.removedA subcontractor was taken off a job; their link stopped.
job_subcontractor.joinedA subcontractor opened their link for the first time, signed in.
job_subcontractor.note_addedA subcontractor left a note on a job.
recovery.openedSomeone asked to take over a shop whose owner cannot be reached.
recovery.decidedA recovery request was decided.
home.claimedA person claimed a home.
home_role.endedA person's role at a home ended.
job.createdA job was started at a home.
job.completedA job was marked done with jobs.complete (W2). override_id is set when the owner overrode open checklist work.
media.uploadedA photo or video was added to a job.
media.taggedTags on a photo changed.
photo_share.createdA share link for job photos was made. It expires on its own and can be revoked.
photo_share.revokedA photo share link was turned off before it expired.
daily_log.addedA worker wrote a daily log entry on a job.
daily_log.removedA daily log entry was taken out (it stays in history).
job_document.createdCore rendered a PDF for a job (photo report or daily log) and stored it with its sha256.
signature.requestedA shop asked someone to sign a document (contract text or a stored job PDF) on a hosted page.
signature.link_issuedA new signing link was made for an open signature request; earlier links stopped working.
signature.cancelledAn open signature request was cancelled.
document.signedA person signed a document on a hosted page. The signature holds the document sha256, the consent text and its sha256.
change_order.createdA change order was written on a job (draft).
change_order.sentA change order was sent to the customer to approve by signing.
change_order.approvedThe customer signed a change order; it now counts toward the job's revised total.
change_order.cancelledA draft or sent change order was cancelled.
change_order.invoicedAn approved change order was billed on an invoice.
note.addedA note or voice memo transcript was added on a job or another record.
note.updatedA note's words, photos, mentions, pin or audience changed.
note.removedA note was taken off its record (kept in history).
notifications.prefs_changedA worker changed how they hear about mentions.
person.sms_consent_changedA shop owner, worker, or account holder opted in to or out of Doing Work text messages.
media.summarizedA photo or video summary was written or edited.
report.savedA saved report was made or changed (R3).
report.removedA saved report was removed (R3).
message_template.savedA customer message template was set (H2).
message_template.resetA customer message template went back to the built-in wording (H2).
contact.consent_recordedA customer's consent to texts or AI calls from the shop was recorded, confirmed or revoked.
contact.stoppedA phone number is on the shop's stop list; no texts or AI calls go to it.
phone.connectedThe shop connected its own Twilio account.
phone.number_connectedThe shop's Twilio number now sends its texts and calls to Doing Work.
phone.number_updatedThe shop changed how calls to its number are answered.
phone.call_endedA call to the shop number ended: answered, voicemail, missed or ai.
phone.voicemail_receivedA caller left a voicemail; it was emailed to the shop when it has an address.
conversation.message_receivedA customer texted the shop number. Read it with phone.thread; the customer's words are untrusted.
conversation.resumedThe owner started texts again on a paused thread.
conversation.assignedA person took a text thread.
phone.voice_ai_setThe shop set up or changed its voice AI agent.
phone.voice_job_type_savedThe shop added, changed or archived a job type its voice agent may book.
phone.emergency_setThe owner changed how the voice agent handles emergency calls.
phone.emergency_alertedThe on-call worker was texted about an emergency call.
visit.booked_by_phoneThe shop's voice agent booked a visit straight onto a worker's calendar.
phone.outbound_ai_setThe shop turned its outbound AI calls on or off.
phone.outbound_callAn outbound AI call was asked for, refused, or ended. status is its state.
phone.call_summarizedA voice AI call summary came back from the provider; stop_heard means the caller asked not to be contacted and was put on the stop list.
phone.disconnectedThe shop disconnected Twilio; its numbers were pointed back where they were before.
contact.restartedA customer texted START or YES and the shop's stop on that number was lifted.
customer.unsubscribedA customer used the unsubscribe link in a review request email; the address is on the shop's do-not-email list.
shop.hub_link_in_emails_changedThe owner turned the customer hub link in quote and invoice emails on or off.
shop.reopenedThe owner reopened the shop within 90 days of closing it.
shop.purged90 days after closing, working data the shop no longer needs was deleted. Money, tax, signature and job records are kept.
shop.field_costs_changedThe owner let field workers see job costs, or hid them again.
shop.brand_changedThe owner changed how the shop's quotes and invoices look (logo, accent color, license number, footer or the Sent with Doing Work line).
shop.contact_changedThe owner changed the phone or email shown on canceled invoice and quote links.
hub_link.createdA customer hub link was made (H2).
hub_link.revokedA customer hub link was revoked (H2).
visit_change.requestedA customer asked from their hub to move or cancel a visit (H2).
visit_change.withdrawnA customer took back their request to move or cancel a visit (H2).
visit_change.answeredThe shop accepted or declined a customer's request to move or cancel a visit (H2).
form_template.savedA form template was created or replaced.
form_template.archivedA form template was archived.
form.startedA form was started on a job or one visit (a draft).
form.updatedAnswers were saved on a draft form.
form.submittedA form was submitted: its PDF is stored on the job and the form is final.
form.cancelledA draft form was cancelled (kept in history).
time.clocked_inA person's clock started (work on a job, drive, shop or break).
time.clocked_outA running clock stopped; the time waits for approval.
time.addedTime was added after the fact (a manual entry); it waits for approval.
time.editedA time entry that was not approved was fixed.
time.approvedThe owner or office approved a time entry; it is locked.
time.rejectedThe owner or office rejected a time entry; the worker can fix it.
time.voidedA time entry that was never approved was taken back.
time.reopenedThe owner reopened approved time so it can be fixed.
labor_rate.setA labor cost rate was set for a worker or the shop default (the amount is not in the event).
material.addedA material used was recorded on a job.
material.updatedA recorded material's quantity, visit or notes changed.
material.removedA recorded material was removed (kept in history).
checklist_template.savedA checklist template was created or replaced.
checklist_template.archivedA checklist template was archived.
checklist.createdA checklist was put on a job or on one visit.
checklist.items_addedItems were added to a checklist.
checklist.item_checkedA checklist item was ticked or unticked.
checklist.item_removedA checklist item was removed (kept in history, audited).
checklist.overriddenThe owner marked a visit or job done with checklist work left. The reason and the open items are in the audit log.
expense.addedA worker recorded an expense on a job (amount typed by the worker).
expense.updatedAn expense was changed.
expense.removedAn expense was taken off the books (kept in history).
approval_rule.setThe owner required approval before agents run an action.
approval_rule.removedThe owner dropped an approval rule.
approval.requestedAn agent action is waiting for the owner's approval.
approval.decidedThe owner approved or denied a held agent action.
media.markup_savedA new markup layer was saved over a photo. The photo itself is unchanged.
customer.createdA customer was added to a shop.
import.completedAn owner finished an import from another system. Imported records do not send their own created events.
quote.createdA quote was written.
quote.sentA quote was locked and sent for signing.
quote.signedThe customer signed a quote.
pricebook.item_savedA price book item was added, changed, archived or brought back.
pricebook.prices_importedDated prices were saved on the price book. The amounts stay on the items.
shop.price_stale_days_changedThe owner or office changed how old a price may be before it shows as stale.
shop.pricing_rules_changedThe owner saved or cleared the pricing rules their assistant reads with quote comparables.
pricebook.prices_appliedA dated price became the current price because its date arrived.
quote_template.savedA quote template was saved, archived or brought back.
quote.declinedThe customer declined a quote on the sign page.
quote.change_requestedThe customer asked for changes to a quote. The quote is back to draft; read the note with quotes.activity.
quote.viewedThe customer opened a sent quote version for the first time.
quote.followup_queuedA follow-up email was queued for a quote the customer has not answered.
crew.savedThe office saved a crew of workers to book together.
crew.archivedA crew was archived. Booked visits keep their workers.
financing.savedThe office saved a financing link. Doing Work does not process financing or charge a fee. The link goes to the shop's financing company.
financing.archivedA financing link was archived and no longer shows on quotes.
shop.margin_alert_changedThe owner set or turned off the profit alert.
shop.morning_email_changedThe owner turned the morning email on or off.
task.createdSomeone made a tracked task, usually from a crew message: a title, maybe a job, a worker and a due time.
task.updatedA task's title, worker, job or due time changed. A new due time re-arms the one chase.
task.closedA task was closed as done or cancelled. Closed tasks are never chased.
agent.followup_dueAn agent's own follow-up is due. Nothing is emailed. A webhook subscriber can wake the agent.
nudge.triggeredAn actionable next-step nudge or check-in is ready for a shop (unbilled work, unsent draft, or scheduled check-in). A webhook subscriber can push or text the user.
agent.snoozedA checkup suggestion was snoozed or dismissed.
shop.kit_list_changedThe owner or office changed the hour of the night-before kit list email, or turned it off.
job.margin_lowAn invoiced job's margin dropped under the shop's profit alert floor. Fires once until the margin climbs back.
shop.quote_followup_changedThe owner changed the quote follow-up delay.
quote.choice_signedThe customer signed a quote with options or optional lines. Says which option and optional lines they picked and the total.
shop.tax_report_basis_changedThe owner chose how the sales tax report counts a period (accrual or cash).
maintenance_plan.tax_changedThe office changed the tax rate a maintenance plan charges from the next term.
shop.tips_changedThe owner turned tips on or off on the pay page.
shop.agent_money_changedThe owner changed what agents may do with money: record outside payments, and the largest refund an agent sends without approval.
shop.review_request_changedThe owner changed the review link or the review email delay.
review.request_queuedA review request email was queued for a customer whose invoice was paid.
card.savedA customer saved a card on the shop's payment account.
card.removedA customer's saved card was removed.
customer.autopay_changedAuto-pay was turned on or off for a customer.
invoice.autopay_startedAn invoice was charged to the customer's saved card. invoice.paid follows when the charge succeeds.
invoice.autopay_failedAn auto-pay charge failed. The invoice stays open.
tax_rate.savedA tax rate was added, replaced or archived. A replaced rate is archived and a new one takes its place.
quote.attachment_addedA photo or file was shown with a quote.
quote.attachment_removedA photo or file was taken off a quote.
maintenance_plan.createdA maintenance plan was started. Its first term's invoice was created.
maintenance_plan.price_changedA worker changed a maintenance plan's price. It applies from the next term.
maintenance_plan.price_proposedAn agent proposed a new price for a maintenance plan. It does not apply until the owner or office confirms it.
shop.send_permissions_changedThe owner changed which roles may send quotes, invoices or visit recaps.
maintenance_plan.visits_changedHow many visits a maintenance plan covers each term changed. Applies from the next term.
maintenance_plan.cancelledA maintenance plan was cancelled. No more renewal invoices.
maintenance_plan.renewedA maintenance plan started its next term and that term's invoice was created (and sent when auto_send is on).
invoice.createdAn invoice was created.
invoice.batch_createdMany invoices were created at once, and maybe sent.
invoice.sentAn invoice was sent for payment.
invoice.payment_pendingA bank payment was started and is clearing. The invoice is not paid yet.
invoice.payment_failedA bank payment failed after it was started. The payer can pay again.
invoice.paidAn invoice was paid.
invoice.paid_outsideThe shop recorded an invoice as paid outside Doing Work (check, cash, financing, insurance or other). The job record says so and is never marked paid or verified.
invoice.voidedThe shop voided an invoice nobody had paid (X3). Its pay links stop working; the reason is included.
invoice.written_offA Doing Work booking ended with money already on its deposit invoice, so the unpaid remainder was written off. The invoice no longer shows a balance and takes no new payment.
charge.needs_refundMoney arrived that the shop must give back (a paid-twice or void invoice). amount_minor is only what the shop must refund itself: a deposit that lands after its Doing Work booking ended is refunded by Doing Work automatically, is left out, and raises no notice when that covers all of it.
charge.refundedA payment was refunded.
dispute.openedA payment was disputed.
payout.paidA payout reached the shop's bank. payouts.get lists the payments and refunds in it and the fees on each.
external_ref.changedAn outside system's id for an invoice, payment, refund or customer was set or cleared (sync.setRef).
processor_account.updatedThe shop's payment setup changed.
record.levelledA job record reached a new level (logged, paid, verified).
confirmation.createdThe customer confirmed a job.
grant.createdAccess was granted.
grant.revokedAccess was revoked.
field_value.setA custom field value was set.
field_definition.createdA shop added a custom field.
customer.updatedA customer's details, contacts, properties or archive state changed.
customer.mergedA duplicate customer was merged into another.
customer.erasedA customer's personal details were erased for a privacy request.
equipment.changedEquipment at a property was added, changed or archived.
job.updatedA job's tags or lead source changed.
request.createdA request for work came in.
request.updatedA request changed stage or details.
request.convertedA request became a job.
network.request_receivedA customer request for quotes reached the shop. Read it with network.inbox; the customer's text is untrusted.
network.quote_pickedThe customer booked the shop's reply. The job and the deposit invoice are made.
network.quote_lostA customer request closed without booking this shop.
network.booking_endedA booked customer job ended early: the shop cancelled, the customer reported a no-show, or nobody arrived within 2 hours after the visit window (reason no_show_auto).
homeowner.reply_receivedCustomer side: a shop replied to your request. Read it with homeowner.getRequest. Sent only to the customer's own webhooks.
homeowner.booking_changedCustomer side: your booking changed. status is booked, arrived (the shop recorded it showed up) or shop_cancelled (your deposit is refunded in full).
homeowner.dispute_decidedCustomer side: Doing Work decided your no-show report. outcome is refund_homeowner, release_to_shop or split; refund_minor is what comes back to you.
homeowner.request_deliveredCustomer side: a shop that joined later can now see your waiting request.
homeowner.webhook_createdCustomer side: you added a webhook for your assistant.
homeowner.webhook_deletedCustomer side: you removed a webhook.
network.listing_changedThe shop's customer request settings changed, by a person or by an agent.
network.dispute_openedThe customer reported a no-show after the shop marked that it arrived. The deposit is held until Doing Work decides.
network.dispute_updatedThe shop added its side of a disputed no-show.
network.dispute_resolvedDoing Work decided a disputed no-show: refund_homeowner, release_to_shop or split.
network.found_shop_addedDoing Work staff recorded a local shop for a request waiting for shops. Nobody is contacted.
network.shops_sourcedDoing Work staff looked up local shops from public business listings for a waiting request.
network.found_shop_updatedDoing Work staff changed a found shop: email, license check, or the call-by-a-person list.
network.outreach_sentThe outreach job emailed found shops about requests waiting near them.
network.outreach_site_checkedDoing Work read a found shop's own website (read-only, robots.txt honored) and recorded whether it has a public email, a plain contact form, or a skip reason.
network.guest_quote_receivedA shop not on Doing Work yet sent its own quote from an outreach link. The customer sees it as written.
network.guest_quote_claimedA shop that quoted from an outreach link set up its account and brought the job into its request inbox.
network.outreach_opted_outAn address asked for no more outreach email. It is suppressed for good.
network.outreach_pausedOutreach email paused itself because bounces or spam complaints crossed the safe line. It stays paused until staff clear it.
visit.scheduledA visit to a job was booked.
calendar_feed.createdA calendar feed link (.ics) was made for a worker. A feed it replaced was turned off.
calendar_feed.revokedA calendar feed link was turned off.
books.exportedA books export (ledger and QuickBooks Online import files) was made for a period.
payroll.period_setThe shop's pay period changed (weekly, biweekly, semimonthly or monthly).
stock.changedA tracked material's count on hand changed (counted, received, used, returned, lost or adjusted). When the change takes it to or below its low point, stock.low is sent instead.
stock.lowA tracked material's count on hand fell to or below its low point (sent once per crossing; it goes again only after the count rises above the low point).
service_due.createdA customer's next service due date was recorded.
service_due.changedAn open service due date's title, date or repeat changed; reminder_reset is true when a moved date re-arms the reminder email.
service_due.completedA service due date was marked done; next_id is the next one when it repeats.
service_due.cancelledA service due date was cancelled; no reminder goes out for it.
service_due.remindedThe "service is due" reminder email was queued for the customer.
shop.service_due_emails_changedThe shop turned "service is due" reminder emails on or off or changed the lead days.
visit.priority_setA visit's priority changed (normal, urgent or emergency). Urgent and emergency visits can use dispatch.suggest.
visit.updatedA visit moved or its details changed.
route.location_setThe map point for a job's address was saved (by an agent or typed in).
route.start_setA worker's start point, or the shop yard (person_id null), was saved.
vendor.savedA supplier was added or changed.
po.createdA purchase order was started (draft). Nothing is job cost until it is received.
po.updatedA draft purchase order changed.
po.orderedA purchase order was marked as sent to the supplier.
po.receivedParts on a purchase order arrived and were added to the job as materials.
po.receipt_undoneA received material from a purchase order was taken back.
po.cancelledA purchase order was cancelled.
po.billedThe supplier's bill was recorded on a purchase order (not job cost).
route.appliedA planned route was written back with routes.apply. Each moved visit also sends visit.updated.
visit.assignedThe workers on a visit changed.
visit.cancelledA visit was cancelled.
visit.startedA worker started a visit.
visit.doneA visit was marked done.
visit.series_createdA repeating set of visits was booked.
availability.changedA worker's weekly hours or time off changed.
visit.on_the_wayA worker is on the way to a visit, with an ETA when given.
visit.arrivedA worker arrived at a visit.
visit.notice_queuedA customer notice for a visit (appointment reminder, on the way, or arrived) was handed to text, email, or both.
schedule.hours_changedThe shop's booking hours changed.
schedule.booking_page_changedThe shop updated its public booking page or Google booking profile.
schedule.open_slots_changedThe shop added or removed times its voice agent may book.
visit.recording_startedRetired Nov 3, 2026: no longer emitted.
visit.recording_finishedRetired Nov 3, 2026: no longer emitted.
visit.recording_addedA worker's walkthrough recording was added to a visit; its transcript is a voice memo note.
visit.recap_draftedA recap email for the customer was drafted after a visit. Not sent until the worker approves it.
visit.recap_editedThe words of a visit recap draft changed.
visit.recap_approvedThe worker approved a visit recap and it was queued to the customer by email.
visit.steps_changedThe shop changed its guided visit steps, or went back to the defaults.
visit.step_markedA guided visit step was marked done, skipped, or open again.
quote.draft_startedThe agent drafted quote lines from a visit. Each line waits on the worker's approval.
quote.draft_line_decidedThe worker approved or rejected one drafted quote line.
agent.correction_recordedA worker edited, rejected or flagged something the agent drafted; the shop keeps the correction for the next draft.
request.lead_settings_changedThe shop's lead rules changed (auto first reply, after hours, flag and skip types).
schedule.settings_changedThe shop's scheduling rules changed (arrival window, buffer, reminders, on the way notices, arrival notices, time zone).
invoice.pay_link_ready_queuedOne email was queued telling the customer an invoice can be paid again after its pay link waited on the shop's payments account.
signature.copy_queuedOne email was queued giving a signer their own copy of what they signed (a document, a quote or a subcontractor list).
card.resave_queuedOne email was queued asking a customer to save their card again after the shop's payments account changed.
invoice.reminder_queuedA friendly reminder was queued for an invoice still unpaid a day after it was sent.
shop.invoice_reminders_changedThe owner turned the automatic unpaid-invoice reminder on or off for the shop.
invoice.reminder_changedThe automatic unpaid reminder was turned on or off for one invoice.
request_form.createdA shop turned on or renewed its public request form.
webhook_endpoint.createdA webhook endpoint was added.
webhook_endpoint.deletedA webhook endpoint was removed.
webhook_delivery.retriedAn owner or office worker queued a failed webhook delivery to send again.
webhook_endpoint.creator_leftThe worker who added a webhook endpoint left the shop. The endpoint keeps running; the owner can keep it or remove it.
agent_key.createdThe owner made a named agent key for the shop.
agent_key.revokedThe owner revoked a named agent key. It stops working at once.
platform.createdA developer platform account was created.