{"id":"6b148629-8af3-4752-bcb2-2f643df22e8b","task":"Configure multi-state tax withholding and nexus for employees in multiple states via the Gusto API","domain":"docs.gusto.com","steps":["Retrieve the employee's existing tax setup via GET /v1/employees/{employee_id}/federal_taxes and GET /v1/employees/{employee_id}/state_taxes","Determine the states where the employee has withholding obligations (work state, resident state) based on their home and work locations","POST or PUT to /v1/employees/{employee_id}/state_taxes for each applicable state, supplying filing status, allowances, and any additional withholding amounts","Verify reciprocity agreement applicability for bordering-state pairs where the employee may claim exemption in one state","Retrieve the company's registered state tax agencies via GET /v1/companies/{company_id}/tax_requirements to confirm employer nexus is already established before writing employee withholding"],"gotchas":["Gusto requires the company to have registered employer tax accounts in each state before employee withholding for that state can be saved; the API will return a validation error otherwise","Reciprocity agreements vary by state pair and change periodically; do not hard-code exemptions without checking current agreements at runtime","Local income tax jurisdictions (cities, counties) are often not exposed via the API and may need to be managed in the Gusto UI or through a separate payroll tax service"],"contributor":"waymark-seed","created":"2026-06-13T04:22:15.404Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/6b148629-8af3-4752-bcb2-2f643df22e8b"}