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.
| Event | What happened |
|---|---|
shop.created | A shop was created. |
membership.invited | A person was invited to a shop. |
membership.role_changed | A worker's role in a shop changed. The old membership ended and a new one started. |
quote.revised | An unsigned quote was replaced by a new version. |
quote.withdrawn | The shop took back an unsigned quote; its signing links stopped working. |
charge.succeeded | A payment succeeded. |
dispute.closed | A payment dispute closed (won, lost or closed). |
plan.changed | A shop changed plan. |
subcontractor_list.signed | A shop signed the Idaho 45-525(3) subcontractor list for a job. |
subcontractor_list.prepared | An agent prepared the Idaho 45-525(3) subcontractor list for a person to sign. |
plan.change_scheduled | A shop scheduled a move down; it starts on the first day of effective_period (shop time). |
fee.owed_to_shop | A fee that was credited against a plan price is owed back to the shop after a refund or lost dispute. |
plan.billed | Not sent. Doing Work has no plans or monthly fee; kept so old subscriptions stay valid. |
membership.started | A person joined a shop. |
membership.ended | A person's membership in a shop ended. |
membership.permissions_changed | The owner changed what a worker may do: see_prices, see_costs, take_money, delete and manage_schedule. |
ownership.transfer_started | The owner started handing the shop to someone else. |
ownership.transferred | Shop ownership moved to a new owner. |
ownership.transfer_cancelled | An open hand-off was stopped: the owner cancelled it or the person asked declined. |
shop.closed | The owner closed the shop. Everyone lost access and every link stopped; records are kept. |
job_subcontractor.added | A subcontractor was added to a job. |
job_subcontractor.updated | A subcontractor's contact name, trade or scope note changed. |
job_subcontractor.removed | A subcontractor was taken off a job; their link stopped. |
job_subcontractor.joined | A subcontractor opened their link for the first time, signed in. |
job_subcontractor.note_added | A subcontractor left a note on a job. |
recovery.opened | Someone asked to take over a shop whose owner cannot be reached. |
recovery.decided | A recovery request was decided. |
home.claimed | A person claimed a home. |
home_role.ended | A person's role at a home ended. |
job.created | A job was started at a home. |
job.completed | A job was marked done with jobs.complete (W2). override_id is set when the owner overrode open checklist work. |
media.uploaded | A photo or video was added to a job. |
media.tagged | Tags on a photo changed. |
photo_share.created | A share link for job photos was made. It expires on its own and can be revoked. |
photo_share.revoked | A photo share link was turned off before it expired. |
daily_log.added | A worker wrote a daily log entry on a job. |
daily_log.removed | A daily log entry was taken out (it stays in history). |
job_document.created | Core rendered a PDF for a job (photo report or daily log) and stored it with its sha256. |
signature.requested | A shop asked someone to sign a document (contract text or a stored job PDF) on a hosted page. |
signature.link_issued | A new signing link was made for an open signature request; earlier links stopped working. |
signature.cancelled | An open signature request was cancelled. |
document.signed | A person signed a document on a hosted page. The signature holds the document sha256, the consent text and its sha256. |
change_order.created | A change order was written on a job (draft). |
change_order.sent | A change order was sent to the customer to approve by signing. |
change_order.approved | The customer signed a change order; it now counts toward the job's revised total. |
change_order.cancelled | A draft or sent change order was cancelled. |
change_order.invoiced | An approved change order was billed on an invoice. |
note.added | A note or voice memo transcript was added on a job or another record. |
note.updated | A note's words, photos, mentions, pin or audience changed. |
note.removed | A note was taken off its record (kept in history). |
notifications.prefs_changed | A worker changed how they hear about mentions. |
person.sms_consent_changed | A shop owner, worker, or account holder opted in to or out of Doing Work text messages. |
media.summarized | A photo or video summary was written or edited. |
report.saved | A saved report was made or changed (R3). |
report.removed | A saved report was removed (R3). |
message_template.saved | A customer message template was set (H2). |
message_template.reset | A customer message template went back to the built-in wording (H2). |
contact.consent_recorded | A customer's consent to texts or AI calls from the shop was recorded, confirmed or revoked. |
contact.stopped | A phone number is on the shop's stop list; no texts or AI calls go to it. |
phone.connected | The shop connected its own Twilio account. |
phone.number_connected | The shop's Twilio number now sends its texts and calls to Doing Work. |
phone.number_updated | The shop changed how calls to its number are answered. |
phone.call_ended | A call to the shop number ended: answered, voicemail, missed or ai. |
phone.voicemail_received | A caller left a voicemail; it was emailed to the shop when it has an address. |
conversation.message_received | A customer texted the shop number. Read it with phone.thread; the customer's words are untrusted. |
conversation.resumed | The owner started texts again on a paused thread. |
conversation.assigned | A person took a text thread. |
phone.voice_ai_set | The shop set up or changed its voice AI agent. |
phone.voice_job_type_saved | The shop added, changed or archived a job type its voice agent may book. |
phone.emergency_set | The owner changed how the voice agent handles emergency calls. |
phone.emergency_alerted | The on-call worker was texted about an emergency call. |
visit.booked_by_phone | The shop's voice agent booked a visit straight onto a worker's calendar. |
phone.outbound_ai_set | The shop turned its outbound AI calls on or off. |
phone.outbound_call | An outbound AI call was asked for, refused, or ended. status is its state. |
phone.call_summarized | A 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.disconnected | The shop disconnected Twilio; its numbers were pointed back where they were before. |
contact.restarted | A customer texted START or YES and the shop's stop on that number was lifted. |
customer.unsubscribed | A 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_changed | The owner turned the customer hub link in quote and invoice emails on or off. |
shop.reopened | The owner reopened the shop within 90 days of closing it. |
shop.purged | 90 days after closing, working data the shop no longer needs was deleted. Money, tax, signature and job records are kept. |
shop.field_costs_changed | The owner let field workers see job costs, or hid them again. |
shop.brand_changed | The 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_changed | The owner changed the phone or email shown on canceled invoice and quote links. |
hub_link.created | A customer hub link was made (H2). |
hub_link.revoked | A customer hub link was revoked (H2). |
visit_change.requested | A customer asked from their hub to move or cancel a visit (H2). |
visit_change.withdrawn | A customer took back their request to move or cancel a visit (H2). |
visit_change.answered | The shop accepted or declined a customer's request to move or cancel a visit (H2). |
form_template.saved | A form template was created or replaced. |
form_template.archived | A form template was archived. |
form.started | A form was started on a job or one visit (a draft). |
form.updated | Answers were saved on a draft form. |
form.submitted | A form was submitted: its PDF is stored on the job and the form is final. |
form.cancelled | A draft form was cancelled (kept in history). |
time.clocked_in | A person's clock started (work on a job, drive, shop or break). |
time.clocked_out | A running clock stopped; the time waits for approval. |
time.added | Time was added after the fact (a manual entry); it waits for approval. |
time.edited | A time entry that was not approved was fixed. |
time.approved | The owner or office approved a time entry; it is locked. |
time.rejected | The owner or office rejected a time entry; the worker can fix it. |
time.voided | A time entry that was never approved was taken back. |
time.reopened | The owner reopened approved time so it can be fixed. |
labor_rate.set | A labor cost rate was set for a worker or the shop default (the amount is not in the event). |
material.added | A material used was recorded on a job. |
material.updated | A recorded material's quantity, visit or notes changed. |
material.removed | A recorded material was removed (kept in history). |
checklist_template.saved | A checklist template was created or replaced. |
checklist_template.archived | A checklist template was archived. |
checklist.created | A checklist was put on a job or on one visit. |
checklist.items_added | Items were added to a checklist. |
checklist.item_checked | A checklist item was ticked or unticked. |
checklist.item_removed | A checklist item was removed (kept in history, audited). |
checklist.overridden | The owner marked a visit or job done with checklist work left. The reason and the open items are in the audit log. |
expense.added | A worker recorded an expense on a job (amount typed by the worker). |
expense.updated | An expense was changed. |
expense.removed | An expense was taken off the books (kept in history). |
approval_rule.set | The owner required approval before agents run an action. |
approval_rule.removed | The owner dropped an approval rule. |
approval.requested | An agent action is waiting for the owner's approval. |
approval.decided | The owner approved or denied a held agent action. |
media.markup_saved | A new markup layer was saved over a photo. The photo itself is unchanged. |
customer.created | A customer was added to a shop. |
import.completed | An owner finished an import from another system. Imported records do not send their own created events. |
quote.created | A quote was written. |
quote.sent | A quote was locked and sent for signing. |
quote.signed | The customer signed a quote. |
pricebook.item_saved | A price book item was added, changed, archived or brought back. |
pricebook.prices_imported | Dated prices were saved on the price book. The amounts stay on the items. |
shop.price_stale_days_changed | The owner or office changed how old a price may be before it shows as stale. |
shop.pricing_rules_changed | The owner saved or cleared the pricing rules their assistant reads with quote comparables. |
pricebook.prices_applied | A dated price became the current price because its date arrived. |
quote_template.saved | A quote template was saved, archived or brought back. |
quote.declined | The customer declined a quote on the sign page. |
quote.change_requested | The customer asked for changes to a quote. The quote is back to draft; read the note with quotes.activity. |
quote.viewed | The customer opened a sent quote version for the first time. |
quote.followup_queued | A follow-up email was queued for a quote the customer has not answered. |
crew.saved | The office saved a crew of workers to book together. |
crew.archived | A crew was archived. Booked visits keep their workers. |
financing.saved | The 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.archived | A financing link was archived and no longer shows on quotes. |
shop.margin_alert_changed | The owner set or turned off the profit alert. |
shop.morning_email_changed | The owner turned the morning email on or off. |
task.created | Someone made a tracked task, usually from a crew message: a title, maybe a job, a worker and a due time. |
task.updated | A task's title, worker, job or due time changed. A new due time re-arms the one chase. |
task.closed | A task was closed as done or cancelled. Closed tasks are never chased. |
agent.followup_due | An agent's own follow-up is due. Nothing is emailed. A webhook subscriber can wake the agent. |
nudge.triggered | An 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.snoozed | A checkup suggestion was snoozed or dismissed. |
shop.kit_list_changed | The owner or office changed the hour of the night-before kit list email, or turned it off. |
job.margin_low | An invoiced job's margin dropped under the shop's profit alert floor. Fires once until the margin climbs back. |
shop.quote_followup_changed | The owner changed the quote follow-up delay. |
quote.choice_signed | The customer signed a quote with options or optional lines. Says which option and optional lines they picked and the total. |
shop.tax_report_basis_changed | The owner chose how the sales tax report counts a period (accrual or cash). |
maintenance_plan.tax_changed | The office changed the tax rate a maintenance plan charges from the next term. |
shop.tips_changed | The owner turned tips on or off on the pay page. |
shop.agent_money_changed | The owner changed what agents may do with money: record outside payments, and the largest refund an agent sends without approval. |
shop.review_request_changed | The owner changed the review link or the review email delay. |
review.request_queued | A review request email was queued for a customer whose invoice was paid. |
card.saved | A customer saved a card on the shop's payment account. |
card.removed | A customer's saved card was removed. |
customer.autopay_changed | Auto-pay was turned on or off for a customer. |
invoice.autopay_started | An invoice was charged to the customer's saved card. invoice.paid follows when the charge succeeds. |
invoice.autopay_failed | An auto-pay charge failed. The invoice stays open. |
tax_rate.saved | A tax rate was added, replaced or archived. A replaced rate is archived and a new one takes its place. |
quote.attachment_added | A photo or file was shown with a quote. |
quote.attachment_removed | A photo or file was taken off a quote. |
maintenance_plan.created | A maintenance plan was started. Its first term's invoice was created. |
maintenance_plan.price_changed | A worker changed a maintenance plan's price. It applies from the next term. |
maintenance_plan.price_proposed | An agent proposed a new price for a maintenance plan. It does not apply until the owner or office confirms it. |
shop.send_permissions_changed | The owner changed which roles may send quotes, invoices or visit recaps. |
maintenance_plan.visits_changed | How many visits a maintenance plan covers each term changed. Applies from the next term. |
maintenance_plan.cancelled | A maintenance plan was cancelled. No more renewal invoices. |
maintenance_plan.renewed | A maintenance plan started its next term and that term's invoice was created (and sent when auto_send is on). |
invoice.created | An invoice was created. |
invoice.batch_created | Many invoices were created at once, and maybe sent. |
invoice.sent | An invoice was sent for payment. |
invoice.payment_pending | A bank payment was started and is clearing. The invoice is not paid yet. |
invoice.payment_failed | A bank payment failed after it was started. The payer can pay again. |
invoice.paid | An invoice was paid. |
invoice.paid_outside | The 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.voided | The shop voided an invoice nobody had paid (X3). Its pay links stop working; the reason is included. |
invoice.written_off | A 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_refund | Money 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.refunded | A payment was refunded. |
dispute.opened | A payment was disputed. |
payout.paid | A payout reached the shop's bank. payouts.get lists the payments and refunds in it and the fees on each. |
external_ref.changed | An outside system's id for an invoice, payment, refund or customer was set or cleared (sync.setRef). |
processor_account.updated | The shop's payment setup changed. |
record.levelled | A job record reached a new level (logged, paid, verified). |
confirmation.created | The customer confirmed a job. |
grant.created | Access was granted. |
grant.revoked | Access was revoked. |
field_value.set | A custom field value was set. |
field_definition.created | A shop added a custom field. |
customer.updated | A customer's details, contacts, properties or archive state changed. |
customer.merged | A duplicate customer was merged into another. |
customer.erased | A customer's personal details were erased for a privacy request. |
equipment.changed | Equipment at a property was added, changed or archived. |
job.updated | A job's tags or lead source changed. |
request.created | A request for work came in. |
request.updated | A request changed stage or details. |
request.converted | A request became a job. |
network.request_received | A customer request for quotes reached the shop. Read it with network.inbox; the customer's text is untrusted. |
network.quote_picked | The customer booked the shop's reply. The job and the deposit invoice are made. |
network.quote_lost | A customer request closed without booking this shop. |
network.booking_ended | A 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_received | Customer side: a shop replied to your request. Read it with homeowner.getRequest. Sent only to the customer's own webhooks. |
homeowner.booking_changed | Customer 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_decided | Customer 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_delivered | Customer side: a shop that joined later can now see your waiting request. |
homeowner.webhook_created | Customer side: you added a webhook for your assistant. |
homeowner.webhook_deleted | Customer side: you removed a webhook. |
network.listing_changed | The shop's customer request settings changed, by a person or by an agent. |
network.dispute_opened | The customer reported a no-show after the shop marked that it arrived. The deposit is held until Doing Work decides. |
network.dispute_updated | The shop added its side of a disputed no-show. |
network.dispute_resolved | Doing Work decided a disputed no-show: refund_homeowner, release_to_shop or split. |
network.found_shop_added | Doing Work staff recorded a local shop for a request waiting for shops. Nobody is contacted. |
network.shops_sourced | Doing Work staff looked up local shops from public business listings for a waiting request. |
network.found_shop_updated | Doing Work staff changed a found shop: email, license check, or the call-by-a-person list. |
network.outreach_sent | The outreach job emailed found shops about requests waiting near them. |
network.outreach_site_checked | Doing 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_received | A shop not on Doing Work yet sent its own quote from an outreach link. The customer sees it as written. |
network.guest_quote_claimed | A shop that quoted from an outreach link set up its account and brought the job into its request inbox. |
network.outreach_opted_out | An address asked for no more outreach email. It is suppressed for good. |
network.outreach_paused | Outreach email paused itself because bounces or spam complaints crossed the safe line. It stays paused until staff clear it. |
visit.scheduled | A visit to a job was booked. |
calendar_feed.created | A calendar feed link (.ics) was made for a worker. A feed it replaced was turned off. |
calendar_feed.revoked | A calendar feed link was turned off. |
books.exported | A books export (ledger and QuickBooks Online import files) was made for a period. |
payroll.period_set | The shop's pay period changed (weekly, biweekly, semimonthly or monthly). |
stock.changed | A 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.low | A 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.created | A customer's next service due date was recorded. |
service_due.changed | An 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.completed | A service due date was marked done; next_id is the next one when it repeats. |
service_due.cancelled | A service due date was cancelled; no reminder goes out for it. |
service_due.reminded | The "service is due" reminder email was queued for the customer. |
shop.service_due_emails_changed | The shop turned "service is due" reminder emails on or off or changed the lead days. |
visit.priority_set | A visit's priority changed (normal, urgent or emergency). Urgent and emergency visits can use dispatch.suggest. |
visit.updated | A visit moved or its details changed. |
route.location_set | The map point for a job's address was saved (by an agent or typed in). |
route.start_set | A worker's start point, or the shop yard (person_id null), was saved. |
vendor.saved | A supplier was added or changed. |
po.created | A purchase order was started (draft). Nothing is job cost until it is received. |
po.updated | A draft purchase order changed. |
po.ordered | A purchase order was marked as sent to the supplier. |
po.received | Parts on a purchase order arrived and were added to the job as materials. |
po.receipt_undone | A received material from a purchase order was taken back. |
po.cancelled | A purchase order was cancelled. |
po.billed | The supplier's bill was recorded on a purchase order (not job cost). |
route.applied | A planned route was written back with routes.apply. Each moved visit also sends visit.updated. |
visit.assigned | The workers on a visit changed. |
visit.cancelled | A visit was cancelled. |
visit.started | A worker started a visit. |
visit.done | A visit was marked done. |
visit.series_created | A repeating set of visits was booked. |
availability.changed | A worker's weekly hours or time off changed. |
visit.on_the_way | A worker is on the way to a visit, with an ETA when given. |
visit.arrived | A worker arrived at a visit. |
visit.notice_queued | A customer notice for a visit (appointment reminder, on the way, or arrived) was handed to text, email, or both. |
schedule.hours_changed | The shop's booking hours changed. |
schedule.booking_page_changed | The shop updated its public booking page or Google booking profile. |
schedule.open_slots_changed | The shop added or removed times its voice agent may book. |
visit.recording_started | Retired Nov 3, 2026: no longer emitted. |
visit.recording_finished | Retired Nov 3, 2026: no longer emitted. |
visit.recording_added | A worker's walkthrough recording was added to a visit; its transcript is a voice memo note. |
visit.recap_drafted | A recap email for the customer was drafted after a visit. Not sent until the worker approves it. |
visit.recap_edited | The words of a visit recap draft changed. |
visit.recap_approved | The worker approved a visit recap and it was queued to the customer by email. |
visit.steps_changed | The shop changed its guided visit steps, or went back to the defaults. |
visit.step_marked | A guided visit step was marked done, skipped, or open again. |
quote.draft_started | The agent drafted quote lines from a visit. Each line waits on the worker's approval. |
quote.draft_line_decided | The worker approved or rejected one drafted quote line. |
agent.correction_recorded | A worker edited, rejected or flagged something the agent drafted; the shop keeps the correction for the next draft. |
request.lead_settings_changed | The shop's lead rules changed (auto first reply, after hours, flag and skip types). |
schedule.settings_changed | The shop's scheduling rules changed (arrival window, buffer, reminders, on the way notices, arrival notices, time zone). |
invoice.pay_link_ready_queued | One 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_queued | One email was queued giving a signer their own copy of what they signed (a document, a quote or a subcontractor list). |
card.resave_queued | One email was queued asking a customer to save their card again after the shop's payments account changed. |
invoice.reminder_queued | A friendly reminder was queued for an invoice still unpaid a day after it was sent. |
shop.invoice_reminders_changed | The owner turned the automatic unpaid-invoice reminder on or off for the shop. |
invoice.reminder_changed | The automatic unpaid reminder was turned on or off for one invoice. |
request_form.created | A shop turned on or renewed its public request form. |
webhook_endpoint.created | A webhook endpoint was added. |
webhook_endpoint.deleted | A webhook endpoint was removed. |
webhook_delivery.retried | An owner or office worker queued a failed webhook delivery to send again. |
webhook_endpoint.creator_left | The worker who added a webhook endpoint left the shop. The endpoint keeps running; the owner can keep it or remove it. |
agent_key.created | The owner made a named agent key for the shop. |
agent_key.revoked | The owner revoked a named agent key. It stops working at once. |
platform.created | A developer platform account was created. |