Intuit V4 Payroll - Insomnia Setup

intuit-v4-workspace-payroll-prod.md

GraphQL Client Setup - Insomnia

We will be using a GraphQL client named Insomnia to execute API calls against Intuit's V4 APIs. We chose Insomnia for its features such as GraphQL introspection, typeahead support for queries and mutations, and OAuth2 handshake support.

1. Download and install the Insomnia client for your operating system

2. Launch Insomnia

3. Import the Insomnia workspace for Intuit's V4 pre-production environment

   • Open the Insomnia menu
   • Click on Import/Export
   • Click on the Import Data drop down
   • Choose From URL
   • Copy this url and paste it into the URL input box
   • Click Fetch and Import
   • Validate that the Intuit V4 Workspace - Payroll - Prod was imported

4. Update your client ID and client secret in the Intuit V4 Gateway - Prod Insomnia Environment

   • Click on the active environment to drop down the environments menu, which is likely Intuit V4 Gateway - Prod or No Environment
   • Click on Manage Environments
   • Click the Intuit V4 Gateway - Prod environment to configure the settings
   • Update the oauth2_client_id and oauth2_client_secret to reflect your app's keys created on developer.intuit.com
   • Click Done