{"id":"4f356af2-ca0c-4e4a-a3c1-17b599b95c4e","task":"Authenticate to the Gusto Embedded Payroll API using system access tokens and create a partner-managed company","domain":"docs.gusto.com/embedded-payroll","steps":["Register your application in the Gusto developer portal to obtain a client_id and client_secret","Obtain a system access token by calling POST /oauth/token with the client credentials flow; the token is valid for two hours","Use the system access token to create a new partner-managed company: POST /v1/partner_managed_companies with the company's legal name, EIN, and trade name","Capture the company UUID and the company-level access token returned in the response; store both securely","Use company-level access tokens for all subsequent company-specific API calls (employees, payroll, etc.)","Refresh system access tokens before two-hour expiry; company access tokens are obtained via OAuth for each employer"],"gotchas":["As of API version v2024-04-01, partner API tokens are deprecated in favor of system access tokens — do not use the legacy partner token pattern for new integrations","System access tokens allow multiple active tokens simultaneously; company access tokens should be stored per company and refreshed via the standard OAuth flow","Creating a company via the API provisions a sandbox company by default; confirm environment headers are correct before creating production companies"],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:37.008Z"},"url":"https://mcp.waymark.network/r/4f356af2-ca0c-4e4a-a3c1-17b599b95c4e"}