Knowledge base

Connecting to WorkflowMax

This is an in-depth look at connecting your WorkflowMax data to SyncHub. ### In this article... 1. Before you start 1. Getting connected 2. Data flow diagram 3. FAQs 4. Troubleshooting 5. Next steps ### Before you start Before you authorise our connection, you'll need to make sure you have the appropriate administration permissions within WorkflowMax. 1. From your WorkflowMax account, navigate to [Business > Settings > Staff](https://my.workflowmax.com/admin/resourcelist.aspx). 2. Search for the staff member that you would like to add this permission to. 3. Ensure that the staff member has the Administrator privilege. If they don't, tick the checkbox and save the staff settings first. 4. You will now see a new heading appear at the bottom of the page called API Access Privileges. Ensure that the staff member has the Authorise 3rd Party Full Access privilege. If not, tick the checkbox and click Save. ![](https://api.synchub.io/Media/RenderFile?&documentGuid=8c9aaeb2-8622-467a-9a32-4c1ce5815d99&clientID=4&) ### Getting connected 1. Click **Connections** from the main menu 2. Click the **New** button 3. Select **WorkflowMax** ![](https://api.synchub.io/Media/RenderFile?&documentGuid=7a122729-e47b-4b4e-9151-ea1ebf30e9ff&clientID=4&) 4. Give it a name (this is especially useful if you’re creating multiple WorkflowMax connections), then click **Create** ![](https://api.synchub.io/Media/RenderFile?&documentGuid=17a48e8d-371f-4e21-9862-970a78563904&clientID=4&) 5. Review the required permissions on the authorization page, then click **Allow access** ![](https://api.synchub.io/Media/RenderFile?&documentGuid=a7c469dc-d259-4acc-8dc7-3bdd79366626&clientID=4&) 6. Done. Now watch as SyncHub begins [retrieving your historical data](/kb/importingyourhistoricaldata?api=). ### Data flow diagram SyncHub maps the following endpoints from WorkflowMax. Each is mapped into their own table in your data warehouse: ![](https://api.synchub.io/Media/RenderFile?&documentGuid=19a3fe2a-6e0b-40ed-a42a-9a1f893f5137&clientID=4&) ### FAQs #### How frequently is my WorkflowMax data synced? The sync frequency (AKA run frequency) is set based on your plan. Check out [our plans](https://www.synchub.io/pricing). #### Can I connect multiple WorkflowMax accounts? Yes, if you have [a plan](https://www.synchub.io/pricing) that allows for multiple connections then you can add additional WorkflowMax connections by completing the steps above for each connection. #### How do I disconnect from WorkflowMax? To disconnect from within SyncHub, click the **Disconnect** button on the connection dashboard of the WorkflowMax connection you would like to delete. ![](https://api.synchub.io/Media/RenderFile?&documentGuid=d0141fb4-4c8a-48c0-9a4b-af4dca5e142f&clientID=4&) To disconnect from within WorkflowMax, follow these steps: 1. Navigate to **Business** > **Settings** from the main menu. 2. Under the Connections section, select **Add-ons**. 3. Scroll down the API Connections list until you find SyncHub. 4. Select **Disable**. #### How far back does my data go? By default SyncHub will only fetch the last few months of data from WorkflowMax, but you can [backdate the sync](/kb/importingyourhistoricaldata?api=) and pull in all historical data. #### How do I configure what data is synced? SyncHub will automatically sync data from all endpoints/data tables available – see the diagram above for the full list. If you would like to remove any tables, simply go to your [connection dashboard](/kb/connectiondashboardsexplained?api=), click on the table name and click Pause. ### Troubleshooting If you're getting an error when attempting to authenticate the connection, please double check that your account has the appropriate permissions in WorkflowMax. Still getting an error? It may be that you are inadvertently signed in on a different WorkflowMax/Xero account. To check this, please try again using an incognito window on your browser. This will mean you are required to re-log in to your WorkflowMax account during the authentication process. ### Next steps You may now connect to your new data warehouse using the reporting tool of your choice. For more information on the WorkflowMax API, please see the [API documentation](https://www.workflowmax.com/api/overview). You can also learn more about [how SyncHub works](/kb/howsynchubworks?api=) and [how to adjust your connection settings](/kb/connectiondashboardsexplained?api=).