Get your Frontdoor dispatches through an API

What you can build on the Contractor Portal

• Get new dispatches

  Build this

  Reads the dispatches assigned to your company in the Contractor Portal, with each one's Dispatch ID, brand, item and member address.

  Takes

  Received since (optional)

  Returns

  Dispatch ID, brand, dispatch type, trade, item, member name, service address, received date, status

• Check a dispatch's status

  Build this

  Opens one dispatch in the Contractor Portal by Dispatch ID and reads its current status and appointment date.

  Takes

  Dispatch ID

  Returns

  Dispatch ID, status, appointment date, last update

• Get invoice payments

  Build this

  Reads the invoices your company submitted in the Contractor Portal and whether each one has been paid.

  Takes

  Submitted since (optional)

  Returns

  Dispatch ID, invoice submitted date, invoice amount, payment status, paid date, paid amount

• Invoice a dispatch and mark it complete

  Build this

  Opens a dispatch by Dispatch ID, enters the invoice for the finished job and marks the job Complete.

  Takes

  Dispatch ID, completion date, invoice lines with amounts

  Returns

  Dispatch ID, status, invoice total, submitted date

Automate the Contractor Portal with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• New dispatches for the schedulers, every morning

  Build this

  Starts

  Every weekday at 7:00

  Step 1

  Get the dispatches received since yesterday.

  Step 2

  Keep the Dispatch IDs that were not there on the last run.

  Step 3

  Email you the list grouped by trade, with item, member name and service address.

• Dispatch status changes, posted to your dispatch board

  Build this

  Starts

  Every hour on weekdays

  Step 1

  Get your company's dispatches and keep the ones that are still open.

  Step 2

  For each open dispatch, check its status and appointment date.

  Step 3

  Keep the dispatches whose status or appointment date changed since the last run.

  Step 4

  Post Dispatch ID, status, appointment date and last update to your webhook.

• Paid invoices, handed to your accounting system

  Build this

  Starts

  Every weekday at 18:00

  Step 1

  Get the invoices submitted in the last 30 days with their payment status.

  Step 2

  Keep the invoices that turned paid since the last run, and stop when there are none.

  Step 3

  Post Dispatch ID, invoice amount, paid date and paid amount to your accounting webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get new dispatches” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "contractor.frontdoorhome.com/get_new_dispatches",
    "input": {
      "received_since": "2026-11-11"
    }
  }'

{
  "status": "completed",
  "data": {
    "dispatches": [
      {
        "dispatch_id": "D-48213067",
        "brand": "American Home Shield",
        "dispatch_type": "Normal",
        "trade": "HVAC",
        "item": "Central air conditioner, not cooling",
        "member_name": "Acme Household",
        "service_address": "1200 Northwind Ave, Memphis, TN 38103",
        "received_date": "2026-11-11",
        "status": "New"
      }
    ]
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The Contractor Portal’s own options

Frontdoor's pages for Pros describe the Contractor Portal as where you manage dispatches, with payment in as little as 10 business days of submission. Authorizations and part requests go through the online SmartAutho and SmartParts tools, or by phone to the Specialized Authorization Team. Frontdoor's contractor pages describe no API for network contractors.

Read on November 12, 2026: Frontdoor: How to become a Frontdoor Pro, Frontdoor: Video diagnoses overview (PDF), American Home Shield: Pros.

Signing in to the Contractor Portal

The Contractor Portal signs you in on login.frontdoorhome.com with your email and password, with a Forgot Password link for resets. With Fous you sign in once through that same page with your own account. The login is sealed with AES-256 and never reaches your code or AI agents, and when a session expires Fous signs back in.

Worth knowing

Use the Dispatch ID exactly as emailed

Frontdoor tells contractors to enter the Dispatch ID exactly as it appears in the dispatch email. Key your own records and every method input on that same ID.

Some authorizations need a phone call

Immediate authorizations, denied items and repairs with non-covered charges go to the Specialized Authorization Team by phone. The other cases go online through SmartAutho or SmartParts.

Invoice first, then mark the job Complete

Frontdoor's guidance for a job resolved on a video call is to invoice it and then mark it Complete, or set Job Complete if the follow-up call does not reach the customer.

Status updates are filed by Dispatch ID

Some contractor dispatch software uploads AHS status codes for each Dispatch ID at least once every 24 hours, such as 30 for Appointment Set and 130 for Possible Denial.

More in Trades, field service and facilities

• Travis Perkins
• GreenSky merchant portal
• CorrigoPro
• Housecall Pro
• Gas Safe Register online services
• LennoxPros
• Carrier Enterprise
• Johnstone Supply
• PowerClerk
• Angi Pro
• Thumbtack Pro
• Checkatrade
• HD Supply
• Ferguson
• Reece maX
• XactAnalysis
• SRS Roof Hub
• GC ONLINE PLUS
• Enphase Installer Platform
• Bunnings PowerPass

Other industries: OpenInvoice, a3innuva, Yelp for Business, Nexpart, Stellantis DealerCONNECT, Paycom.