{"id":"3e24d8db-08bc-4484-a29e-6e20507e76ab","task":"Automate Bill.com AP bill approval workflow and sync vendor records","domain":"developer.bill.com","steps":["Authenticate to the Bill.com API and obtain a session ID scoped to the target organization","Sync vendor records by querying the Vendor list endpoint and upserting into your local system using the Bill.com vendor ID as the key","Create a Bill by POSTing to the Bill endpoint with vendor ID, invoice date, due date, and line items referencing chart-of-accounts category IDs","Trigger the approval workflow by updating the Bill's approvalStatus to the appropriate pending-approval enum value","Poll the Bill record or use a webhook to detect when the approvalStatus transitions to approved or denied","On approval, initiate payment via the SendPayment endpoint or mark the bill as paid by recording a payment against it"],"gotchas":["Bill.com approval workflows are organization-specific; the valid approval status transitions depend on whether single or multi-step approval is configured, and submitting an invalid transition returns a fault","Vendor bank account data is handled through a separate, restricted API scope; syncing vendor payment details requires explicit permission and cannot be done through the standard vendor sync flow","Bill.com session IDs expire after a period of inactivity; long-running batch jobs must refresh the session before it expires to avoid mid-batch authentication failures"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:30.487Z"},"url":"https://mcp.waymark.network/r/3e24d8db-08bc-4484-a29e-6e20507e76ab"}