--- title: Webhooks and events description: Signed webhook deliveries with retries, and every event Doing Work emits. Free field service software for trade shops up to $1,000/month in payments, with. url: https://doingwork.work/docs/webhooks/ --- # Webhooks and events A developer adds an endpoint with their own sign-in ([webhooks.create](https://doingwork.work/docs/reference/webhooks-create/)); the secret is shown once. Deliveries are POSTs with `DW-Signature: t=,v1=`. 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. |