WorkflowMax

Basic

Overview

<h2 class="slate-h2 " >Before you get started</h2><p class="slate-p " >Before you can start using OAuth with WorkflowMax, you will need to have:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">a developer/user account</div></li><li class="slate-li " ><div style="position:relative">a WorkflowMax account to integrate with your developer application*</div></li></ul><p class="slate-p " ><em class="slate-italic">*You must have full access to the “Authorize 3rd Party Full Access” privilege to integrate with a WorkflowMax account.</em></p><h2 class="slate-h2 " >How it works</h2><p class="slate-p " >WorkflowMax supports the <a href="https://developer.okta.com/blog/2018/04/10/oauth-authorization-code-grant-type" target="_blank">OAuth 2.0 Authorization Code grant type</a>, which can be broken down into five basic steps:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Your application opens a browser window to send the user to the OAuth 2.0 server.</div></li><li class="slate-li " ><div style="position:relative">The user reviews the requested permissions and grants the application access.</div></li><li class="slate-li " ><div style="position:relative">The user is redirected back to the application with an authorization code in the query string.</div></li><li class="slate-li " ><div style="position:relative">The application sends a request to the OAuth 2.0 server to exchange the authorization code for an access token.</div></li><li class="slate-li " ><div style="position:relative">Make calls against the API.</div></li></ol><h2 class="slate-h2 " >Getting OAuth 2.0 tokens</h2><div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >Create a developer application</h3><p class="slate-p slate-indent-0" style="0px">Visit the <a href="https://developer.workflowmax.com" target="_blank">WorkflowMax Developer Portal</a> and sign in or register for a developer account.</p><p class="slate-p " >Once logged in, navigate to the application registration section. Provide necessary details such as your application&apos;s name, company or application URL, and the OAuth 2.0 redirect URI (ensure this is an HTTPS address). After submitting, you&apos;ll receive a <strong class="slate-bold">Client ID</strong> and <strong class="slate-bold">Client Secret - </strong>store these securely as they are essential for authentication.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Create the authorisation URL and direct the user to WorkflowMax&apos;s OAuth 2.0 server</h3><p class="slate-p " >When sending a user to WorkflowMax&apos;s OAuth 2.0 server, the first step is creating the authorisation URL. This will identify your application and define the resources (scopes) it&apos;s requesting access to on behalf of the user. </p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >WorkflowMax prompts the user for consent</h3><p class="slate-p " >WorkflowMax displays a consent window to the user showing the name of your application and a short description of the WorkflowMax API services it&apos;s requesting permission to access. The user can then grant access to your app.</p><p class="slate-p " >If any errors occur or the user denies the request, we redirect back to your redirect_uri with an error parameter.</p><p class="slate-p " >Your application doesn&apos;t do anything at this stage. Once access is granted, the OAuth 2.0 server will send a request to the callback URI defined in the authorisation URL.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >4</h6><h3 class="slate-h3 " >Handle the OAuth 2.0 server response</h3><p class="slate-p " >When the user has completed the consent prompt from Step 2, the OAuth 2.0 server sends a GET request to the redirect URI specified in your authentication URL. If there are no issues and the user approves the access request, the request to the redirect URI will be returned with a code query parameter attached.</p><p class="slate-p " >If the user doesn&apos;t grant access, the request to the redirect URI will be returned with a query parameter outlining the error.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >5</h6><h3 class="slate-h3 " >Exchange authorisation code for tokens</h3><p class="slate-p " >After your application receives an authorisation code from the OAuth 2.0 server, it can exchange that code for an access and refresh token.</p><p class="slate-p " >For more information on how to make this API call, refer to <a href="68881883a2dc76ead42596a2/6889bcc144757c646ffaded6" target="_blank">this API endpoint</a>.</p><p class="slate-p " >All tokens received have an associated expiry time. Access tokens and refresh tokens can be exchanged prior to expiry.</p><p class="slate-p " >Token expiry times:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">access_token: 30 minutes</div></li><li class="slate-li " ><div style="position:relative">refresh_token: 60 days.</div></li></ul><p class="slate-p " >The access token is a JWT, which can be <a href="https://jwt.io/" target="_blank">decoded</a> to retrieve the authentication organisation&apos;s Org ID, which will be required to make API calls.</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=warning ><div class="callout-icon"><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p " >If your JWT does not contain an Orgnisation ID, please check that you have completed step 4 correctly by passing the parameters in the body (not as headers).</p></div></div></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >6</h6><h3 class="slate-h3 " >Call the API</h3><p class="slate-p " >Make calls against the WorkflowMax API by following the contracts in other sections of this guide.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >7</h6><h3 class="slate-h3 " >Refresh token (as required)</h3><p class="slate-p slate-indent-0" style="0px">Access tokens expire after 30 minutes. Your application can refresh an access token without user interaction by using a refresh token. You get a refresh token by requesting the offline_access scope during the initial user authorisation. Refresh tokens expire after 60 days.</p><p class="slate-p slate-indent-0" style="0px">Refer to « Insert link here »</p></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Authentication

<p class="slate-p " ><span style="background-color:rgb(255, 255, 255);color:rgba(20, 23, 25, 0.84)">When sending a user to WorkflowMax&apos;s OAuth 2.0 server, the first step is creating the authorisation URL. This will identify your application and define the resources (scopes) it&apos;s requesting access to on behalf of the user.</span></p>

Authorisation Request

<p class="slate-p " ><span style="background-color:rgb(255, 255, 255);color:rgba(20, 23, 25, 0.84)">After your application receives an authorisation code from the OAuth 2.0 server, it can exchange that code for an access and refresh token.</span></p>

Obtain Tokens

<p class="slate-p " ><span style="background-color:rgb(255, 255, 255);color:rgba(20, 23, 25, 0.84)">Access tokens expire after 30 minutes. Your application can refresh an access token without user interaction by using a refresh token. You get a refresh token by requesting the offline_access scope during the initial user authorisation. Refresh tokens expire after 60 days.</span></p>

Refresh Tokens

Base URL

Rate Limiting

Response Format

Error Handling

Feedback & Support

Settings

Returns the current authenticated user and organization context.

GET Me

Account

GET Accounts

Role

Provides a list of all the roles in the setting.

GET Roles

Custom Field

GET Custom Fields

Create a dropdown custom field whose options are from another reference object.

POST Custom Fields

PUT Custom Field {UUID}

Client

Provides a list of all the business Strutures in settings

GET Business Structures

Provides a list of all the client types in settings

GET Client Types

Cost

The "cost" section of the WorkflowMax API V2 allows users to manage and track costs associated with various projects and expenses. Users can create, update, and retrieve cost details such as codes, notes, unit costs, prices, descriptions, and supplier information. This section provides a comprehensive solution for managing financial aspects within the WorkflowMax platform.

POST Cost

PUT Cost {UUID}

DELETE Cost {UUID}

GET Costs

GET Cost {UUID}

GET Job Templates

The 'Get Job Categories' section allows users to retrieve a list of job categories associated with a specific account. By accessing this information, users can efficiently organize and categorize different job types within their system. This API section enables users to streamline their workflow by providing essential information about job categories for effective management.

GET Job Categories

Provides a list of all the job statuses in the job setting.

GET Job Statuses

Staff

The 'staff' section of the WorkflowMax API V2 allows users to manage and update staff member information within their account. With this section, users can modify staff details such as name, rates, contact information, and employment status. By utilizing this API functionality, users can efficiently maintain an up-to-date roster of staff members in their WorkflowMax account.

PUT Staff {UUID}

The "staff" section of the WorkflowMax API V2 allows users to manage and create staff members within their account. With this functionality, users can seamlessly add new team members, update existing staff information, and assign specific roles or permissions as needed. This section provides a comprehensive set of parameters to customize staff profiles, streamlining workforce management processes for efficient operation.

POST Staff

GET Staff {UUID}

GET Staff

Provides a list of all the taxes in settings.

GET Taxes

Lead

Provides a list of all the lead categories.

GET Lead Categories

Task

The Task section of the WorkflowMax API V2 allows users to retrieve information about tasks within their projects. With this API, users can access task details including name, status, start and end dates, and assigned staff members. This section is essential for managing and tracking tasks efficiently within the WorkflowMax platform.

POST Tasks

PUT Task {UUID}

GET Task {UUID}

Provides a list of all the tasks in settings.

GET Tasks

DELETE Task {UUID}

Objects

GET Job {Identifier}

GET Jobs

POST Job

DELETE Job {identifier}

PUT Job {Identifier}

POST Job {Identifier} Job Templates

Job - Cost

GET Job {UUID} costs

POST Job {Identifier} Cost

PUT Job Cost {UUID}

Job - Task

PUT Job Task {UUID}

POST Job {identifier} Task

GET Jobs Tasks

DELETE Job Task {UUID}

Job - Note

POST Jobs {UUID} Notes

Document

Purchase Order

Supplier

Timesheet

PUT Timesheets {UUID}

DELETE Timesheet {UUID}

<p class="slate-p " >Creates a new timesheet entry in the system for a specified staff member, job, and task. Includes details such as date, hours worked, and optional notes. Useful for logging new work hours via integrations, bulk time imports, or automated time tracking workflows.</p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

POST Timesheet

GET Timesheets

Provides detail for a specific timesheet.

GET Timesheet {UUID}

The "client" section in the WorkflowMax API V2 allows users to create new client profiles within the system. With this functionality, users can add detailed information such as contact details, addresses, tax numbers, and custom fields for each client. This section enables users to efficiently manage and organize client data within their workflow.

POST Clients

GET Clients

GET Client {UUID}

Client Group

The Client Group section of the WorkflowMax API V2 allows users to manage and organize clients into groups within their account. Users can create, edit, and delete client groups to efficiently categorize and manage their client relationships. This section provides a streamlined way to organize and track client information for improved workflow and client management.

DELETE Client Group {UUID}

<p class="slate-p " >The client-groups section of the WorkflowMax API V2 allows users to manage and organize clients into specific groups for easier categorization and tracking. By utilizing this section, users can view, create, update, and delete client groups as needed, streamlining their client management processes within the WorkflowMax platform.</p><p class="slate-p " ></p>

GET Client Groups

The client-group section of the WorkflowMax API V2 allows users to manage and retrieve information about client groups associated with their account. Users can create, update, or delete client groups, as well as fetch details such as group name, ID, and associated clients. This section provides a streamlined way to organize and categorize clients within the WorkflowMax system.

GET Client Group {UUID}

The client-group section of the WorkflowMax API V2 allows users to create and manage groups of clients within their account. By leveraging this section, users can efficiently organize and categorize their clients, making it easier to streamline workflows and tailor services to specific groups of clients.

POST Client Group

The "client-group" section of the WorkflowMax API V2 allows users to manage and update client groups within their account. With this functionality, users can organize clients into specific groups for easier management and reporting purposes. This section enables users to define and modify client group settings, streamlining their workflow and enhancing organization within the platform.

PUT Client Group {UUID}

<p class="slate-p " >The &quot;client&quot; section of the WorkflowMax API V2 allows users to manage client information within their account. With this API, users can create new clients, update existing client details, and organize clients into groups for streamlined management. This section provides essential functionality for maintaining accurate and organized client records within the WorkflowMax platform.</p><p class="slate-p " ></p>

POST Client Group {UUID} Client

DELETE Client Group {UUID} Client

Client Contact

The client-contact section of the WorkflowMax API V2 allows users to manage and delete client contact information within the system. This functionality enables users to efficiently remove outdated or unnecessary contact records, ensuring accurate and up-to-date client contact data for effective communication and relationship management.

DELETE Client Contacts {UUID}

Provides detail for an individual contact.

GET Client Contacts {UUID}

The client-contact section of the WorkflowMax API V2 allows users to manage and update contact details for clients. With this functionality, users can modify contact information such as names, email addresses, phone numbers, and custom fields associated with client contacts. This section provides a seamless way to ensure accurate and up-to-date client contact information within the WorkflowMax system.

PUT Client Contacts {UUID}

The client-contact section of the WorkflowMax API V2 allows users to create and manage contacts associated with clients. With this functionality, users can easily add new contacts, update existing contact details, and designate primary contacts for efficient communication and organization within the platform. This section provides a streamlined way to maintain client contact information and enhance client relationship management capabilities.

POST Client Contacts

GET Leads

GET Lead {UUID}

POST Leads

PUT Lead {UUID}

Quote

GET Quotes

GET Quote {UUID}

POST job {UUID} quotes

Invoice

GET Payments

<p class="slate-p " >Retrieves a list of invoices across the account, including summary details such as invoice number, date, client, total amount, and status. Commonly used to build financial dashboards, export billing data, or monitor outstanding payments. Supports filtering by date range, client, status, and includes pagination for large datasets.</p><p class="slate-p " ></p><p class="slate-p " ></p>

GET Invoices

<p class="slate-p " >Returns detailed information for a specific invoice, including client details, job reference, line items, totals, tax amounts, and payment status. Typically used when syncing a single invoice with an external accounting system, validating invoice data, or retrieving a record for display in a custom interface.</p><p class="slate-p " ></p><p class="slate-p " ></p>

GET Invoice {UUID}

Provides a list of costs invoiced by an individual invoice.

GET Invoice {UUID} Costs

POST Purchase Orders

GET Purchase Orders

Provides detail for an individual purchase order.

GET Purchase Order {UUID}

Purchase Order - Bill

POST Purchase Orders {UUID} Bills

Provides a list of all purchase order bills.

GET Purchase Order Bills

Purchase Order - Stock Receipt

Provides a list of all purchase order stock receipts.

GET Purchase Order Stock Receipts

Creates a new stock receipt for a purchase order

POST Purchase Orders {UUID} Stock Receipts

GET Suppliers

GET Supplier {UUID}

<p class="slate-p " >The suppliers section of the WorkflowMax API V2 allows users to create and manage supplier information within their account. By utilizing this section, users can add new suppliers, update existing supplier details, and maintain a comprehensive database of supplier contacts and custom fields. This functionality streamlines supplier management processes and enhances overall workflow efficiency.</p><p class="slate-p " ></p>

POST Suppliers

PUT Supplier {UUID}

The suppliers section of the WorkflowMax API V2 allows users to manage and manipulate supplier information within their account. With this API, users can create, update, retrieve, and delete supplier records, enabling efficient supplier management and organization within their workflow.

DELETE Suppliers

<p class="slate-p " >The Supplier Contacts section of the WorkflowMax API V2 allows users to access and manage contact information for suppliers associated with their projects. By utilizing this API section, users can efficiently retrieve, update, and delete contact details for suppliers, enhancing the effectiveness of their project management processes.</p><p class="slate-p " ></p>

Supplier Contacts

GET Supplier Contact {UUID}

DELETE Supplier Contact {UUID}

Create a new supplier contact for the specified supplier.

POST Supplier {UUID} Contacts

PUT Supplier Contact {UUID}

Default

WorkflowMax API V2

v1.0

Production

Sandbox

<p class="slate-p " >Welcome to the <strong class="slate-bold">WorkflowMax V2 API</strong> – a modern, developer-friendly API designed to help you build powerful integrations with WorkflowMax. Whether you’re automating workflows, building add-ons, or syncing data with other tools, this API gives you structured, secure, and flexible access to your account data.</p><h2 class="slate-h2 " >🌟 What’s New in V2</h2><p class="slate-p " >The V2 API has been built from the ground up to replace the legacy XML‑based V1 API. Key improvements include:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Modern JSON-based structure - </strong>V2 uses clean JSON formatting – making it easier to work with across today’s development environments. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Smarter data retrieval - </strong>More endpoints now support filtering by <code class="slate-code">lastModified</code> timestamp, helping reduce the volume of API calls required to stay up-to-date. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Customisable responses - </strong>Retrieve related data (e.g. custom fields, notes) in a single call, reducing the need for additional lookups. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Broader data access - </strong>Endpoints are more complete, providing access to the full scope of data stored in WorkflowMax. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Ongoing expansion - </strong>We’re continuing to add new endpoints, for example the upcoming support for adding bills to purchase orders. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Webhooks support (coming soon) - </strong>Real-time event monitoring will be available via webhook subscriptions. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Improved developer visibility (coming soon) - </strong>We’re enhancing our developer portal to give you better transparency over your API usage, including logs for each API call made. </div></li></ul><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >If V2 doesn&apos;t have your required endpoint, you may be able to use the <a href="https://app.swaggerhub.com/apis/WorkflowMax-BlueRock/WorkflowMax-BlueRock-OpenAPI3/0.1" target="_blank">V1 API</a> instead.</p></div></div><p class="slate-p " ></p><p class="slate-p " ></p>

 – a modern, developer-friendly API designed to help you build powerful integrations with WorkflowMax. Whether you’re automating workflows, building add-ons, or syncing data with other tools, this API gives you structured, secure, and flexible access to your account data.

The V2 API has been built from the ground up to replace the legacy XML‑based V1 API. Key improvements include:

<h2 class="slate-h2 " >Before you get started</h2><p class="slate-p " >Before you can start using OAuth with WorkflowMax, you will need to have:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">a developer/user account</div></li><li class="slate-li " ><div style="position:relative">a WorkflowMax account to integrate with your developer application*</div></li></ul><p class="slate-p " ><em class="slate-italic">*You must have full access to the “Authorize 3rd Party Full Access” privilege to integrate with a WorkflowMax account.</em></p><h2 class="slate-h2 " >How it works</h2><p class="slate-p " >WorkflowMax supports the <a href="https://developer.okta.com/blog/2018/04/10/oauth-authorization-code-grant-type" target="_blank">OAuth 2.0 Authorization Code grant type</a>, which can be broken down into five basic steps:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Your application opens a browser window to send the user to the OAuth 2.0 server.</div></li><li class="slate-li " ><div style="position:relative">The user reviews the requested permissions and grants the application access.</div></li><li class="slate-li " ><div style="position:relative">The user is redirected back to the application with an authorization code in the query string.</div></li><li class="slate-li " ><div style="position:relative">The application sends a request to the OAuth 2.0 server to exchange the authorization code for an access token.</div></li><li class="slate-li " ><div style="position:relative">Make calls against the API.</div></li></ol><h2 class="slate-h2 " >Getting OAuth 2.0 tokens</h2><div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >Create a developer application</h3><p class="slate-p slate-indent-0" style="0px">Visit the <a href="https://developer.workflowmax.com" target="_blank">WorkflowMax Developer Portal</a> and sign in or register for a developer account.</p><p class="slate-p " >Once logged in, navigate to the application registration section. Provide necessary details such as your application&apos;s name, company or application URL, and the OAuth 2.0 redirect URI (ensure this is an HTTPS address). After submitting, you&apos;ll receive a <strong class="slate-bold">Client ID</strong> and <strong class="slate-bold">Client Secret - </strong>store these securely as they are essential for authentication.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Create the authorisation URL and direct the user to WorkflowMax&apos;s OAuth 2.0 server</h3><p class="slate-p " >When sending a user to WorkflowMax&apos;s OAuth 2.0 server, the first step is creating the authorisation URL. This will identify your application and define the resources (scopes) it&apos;s requesting access to on behalf of the user. </p><p class="slate-p " >For further information, refer to <a href="688accf28033caa3c9c63a8c/688accf28033caa3c9c63a9c" target="_blank">this API endpoint</a>.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >WorkflowMax prompts the user for consent</h3><p class="slate-p " >WorkflowMax displays a consent window to the user showing the name of your application and a short description of the WorkflowMax API services it&apos;s requesting permission to access. The user can then grant access to your app.</p><p class="slate-p " >If any errors occur or the user denies the request, we redirect back to your redirect_uri with an error parameter.</p><p class="slate-p " >Your application doesn&apos;t do anything at this stage. Once access is granted, the OAuth 2.0 server will send a request to the callback URI defined in the authorisation URL.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >4</h6><h3 class="slate-h3 " >Handle the OAuth 2.0 server response</h3><p class="slate-p " >When the user has completed the consent prompt from Step 2, the OAuth 2.0 server sends a GET request to the redirect URI specified in your authentication URL. If there are no issues and the user approves the access request, the request to the redirect URI will be returned with a code query parameter attached.</p><p class="slate-p " >If the user doesn&apos;t grant access, the request to the redirect URI will be returned with a query parameter outlining the error.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >5</h6><h3 class="slate-h3 " >Exchange authorisation code for tokens</h3><p class="slate-p " >After your application receives an authorisation code from the OAuth 2.0 server, it can exchange that code for an access and refresh token.</p><p class="slate-p " >For further information, refer to <a href="68881883a2dc76ead42596a2/6889bcc144757c646ffaded6" target="_blank">this API endpoint</a>.</p><p class="slate-p " >All tokens received have an associated expiry time. Access tokens and refresh tokens can be exchanged prior to expiry.</p><p class="slate-p " >Token expiry times:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">access_token: 30 minutes</div></li><li class="slate-li " ><div style="position:relative">refresh_token: 60 days.</div></li></ul><p class="slate-p " >The access token is a JWT, which can be <a href="https://jwt.io/" target="_blank">decoded</a> to retrieve the authentication organisation&apos;s Org ID, which will be required to make API calls.</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=warning ><div class="callout-icon"><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p " >If your JWT does not contain an Orgnisation ID, please check that you have completed step 4 correctly by passing the parameters in the body (not as headers).</p></div></div></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >6</h6><h3 class="slate-h3 " >Call the API</h3><p class="slate-p " >Make calls against the WorkflowMax API by following the contracts in other sections of this guide.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >7</h6><h3 class="slate-h3 " >Refresh token (as required)</h3><p class="slate-p slate-indent-0" style="0px">Access tokens expire after 30 minutes. Your application can refresh an access token without user interaction by using a refresh token. You get a refresh token by requesting the offline_access scope during the initial user authorisation. Refresh tokens expire after 60 days.</p><p class="slate-p slate-indent-0" style="0px">For further information, refer to <a href="688accf28033caa3c9c63a8c/688accf28033caa3c9c63aa5" target="_blank">this API endpoint</a>.</p></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Before you can start using OAuth with WorkflowMax, you will need to have:

*You must have full access to the “Authorize 3rd Party Full Access” privilege to integrate with a WorkflowMax account.

, which can be broken down into five basic steps:

<p class="slate-p slate-indent-0" style="0px">The Base URL section of the Default project API provides users with the foundational link to access all other endpoints and resources within the API. Use HTTPS for all API calls to ensure data is encrypted in transit. Combine the base URL with your desired endpoint - for example: <code class="slate-code">GET https://api.workflowmax.com/v2/clients</code></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

The Base URL section of the Default project API provides users with the foundational link to access all other endpoints and resources within the API. Use HTTPS for all API calls to ensure data is encrypted in transit. Combine the base URL with your desired endpoint - for example: 

GET https://api.workflowmax.com/v2/clients

<p class="slate-p " >To maintain system reliability and fairness across all users, our API enforces rate limits per client–organisation pair.</p><p class="slate-p " >Each combination of <strong class="slate-bold">Client ID</strong> and <strong class="slate-bold">Account ID</strong> is allowed:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">60 requests per 1-minute rolling window (roughly equivalent to 1 request per second, with short bursts permitted). </div></li><li class="slate-li " ><div style="position:relative">If the limit is exceeded, the API responds with <strong class="slate-bold">HTTP 429 Too Many Requests</strong>, including a <code class="slate-code">Retry-After</code> header specifying when to retry. </div></li></ul><div class="slate-div"><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><div class="slate-div"><p class="slate-p " ><strong class="slate-bold">Tip:</strong> Implement exponential back-off and jitter in your integration to reduce the likelihood of hitting rate limits during spikes.</p></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

To maintain system reliability and fairness across all users, our API enforces rate limits per client–organisation pair.

<p class="slate-p " >All WorkflowMax API responses are returned in JSON format, designed for consistency and ease of integration across modern tech stacks.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Content-Type:</strong> <code class="slate-code">application/json; charset=utf-8</code> </div></li><li class="slate-li " ><div style="position:relative">Timestamps use UTC and ISO 8601 (<code class="slate-code">2025-06-12T04:35:27Z</code>). </div></li><li class="slate-li " ><div style="position:relative">IDs are returned as strings to preserve precision across languages.</div></li></ul><p class="slate-p " >Successful responses are wrapped in a standard envelope:</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
&quot;data&quot;: { … },          // or an array for list endpoints
&quot;meta&quot;: {
&quot;request_id&quot;: &quot;c1b3…&quot;,
&quot;pagination&quot;: { &quot;page&quot;: 2, &quot;per_page&quot;: 50, &quot;total_pages&quot;: 8 }
}
}</div></div></code></pre></div><p class="slate-p " >For list endpoints, you can use <code class="slate-code">page</code> and <code class="slate-code">pagesize</code> parameters to control pagination. </p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

All WorkflowMax API responses are returned in JSON format, designed for consistency and ease of integration across modern tech stacks.

Successful responses are wrapped in a standard envelope:

<p class="slate-p " >The API uses standard HTTP status codes and structured error messages to help you diagnose and respond to problems programmatically.</p><p class="slate-p " ></p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" style="min-width:initial;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:169px;">HTTP Status Code</div><div style="width:345px;">Meaning</div><div style="width:503px;">When it occurs</div></div><colgroup ><col style="width:169px"><col style="width:345px"><col style="width:503px"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >400</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Bad request</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Malformed JSON, incorrect parameters</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >401</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Unauthorised</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Malformed JSON, incorrect parameters</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >403</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Forbidden</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Authenticated, but insufficient scope or org-level access</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >404</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Not found</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Resource does not exist</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >409</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Conflict</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Duplicate or conflicting request</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >422</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Validation failed</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Field-level input errors</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >429</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Too many requests</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Rate limit exceeded</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >500</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Server error</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Internal system fault</p></td></div></tr></tbody></table></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

The API uses standard HTTP status codes and structured error messages to help you diagnose and respond to problems programmatically.

HTTP Status Code

Meaning

When it occurs

<p class="slate-p " >We’re here to help if you encounter issues, have questions, or want to provide feedback as you build with the WorkflowMax API.</p><p class="slate-p " ></p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" style="min-width:initial;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:266px;">Channel</div><div style="width:534px;">Contact</div><div style="width:392px;">Use Case</div></div><colgroup ><col style="width:266px"><col style="width:534px"><col style="width:392px"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Help Centre</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><a href="https://support.workflowmax.com/hc/en-us" target="_self">https://support.workflowmax.com/hc/en-us</a></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Technical issues, login problems, bug repor</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Status Page</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><a href="https://status.workflowmax.com/" target="_self">https://status.workflowmax.com/</a></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Live updates on outages or disruptions</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Feature Suggestions</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><a href="https://workflowmaxbybluerock.ideas.userback.io/p/8hdPOvloNB" target="_self">https://workflowmaxbybluerock.ideas.userback.io/p/8hdPOvloNB</a></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Request new features or improvements</p></td></div></tr></tbody></table></div><p class="slate-p " >When raising a support request, include the following details to help us resolve your issue faster:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">The <code class="slate-code">request_id</code> (found in the <code class="slate-code">meta</code> block of any API response) </div></li><li class="slate-li " ><div style="position:relative">Your <code class="slate-code">Client ID</code> and <code class="slate-code">Organisation ID</code> </div></li><li class="slate-li " ><div style="position:relative">The exact endpoint and timestamp (in UTC) </div></li><li class="slate-li " ><div style="position:relative">Sample request and response bodies (with secrets removed)</div></li></ul><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=warning ><div class="callout-icon"><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p " >WorkflowMax is unable to assist with building or maintaining your API integration. Any guidance provided is general in nature and intended to support your understanding of how the WorkflowMax API operates. We recommend working with a qualified developer to implement and maintain your integration.</p></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

We’re here to help if you encounter issues, have questions, or want to provide feedback as you build with the WorkflowMax API.

Channel

Contact

Use Case

When raising a support request, include the following details to help us resolve your issue faster:

<p class="slate-p " >Accounts in WorkflowMax, also referred to as account codes, are used to categorise income and expenses for jobs, costs, and invoicing. Each account typically includes attributes such as a unique code, name, and type (e.g., income or expense). These codes provide the link between WorkflowMax’s operational data and the financial reporting structure of the business, ensuring consistency and accuracy when tracking project-related revenue and costs.</p><p class="slate-p " >Users interact with account codes primarily in job costing and billing workflows. When costs are recorded or invoices are generated, the associated account codes determine how those amounts are categorised for reporting and, if applicable, exported to accounting software. This helps businesses align operational data with financial statements and enables accurate allocation of income and expenses.</p><p class="slate-p " >When WorkflowMax is integrated with Xero, account codes are synchronised from Xero and cannot be edited within WorkflowMax. In this scenario, Xero serves as the source of truth for financial account structures, ensuring seamless alignment between the two systems. If no Xero integration is enabled, account codes can be managed directly within WorkflowMax under <strong class="slate-bold">General Settings</strong>, allowing organisations to define and maintain their own categorisation scheme.</p><p class="slate-p " ></p>

Accounts in WorkflowMax, also referred to as account codes, are used to categorise income and expenses for jobs, costs, and invoicing. Each account typically includes attributes such as a unique code, name, and type (e.g., income or expense). These codes provide the link between WorkflowMax’s operational data and the financial reporting structure of the business, ensuring consistency and accuracy when tracking project-related revenue and costs.

Users interact with account codes primarily in job costing and billing workflows. When costs are recorded or invoices are generated, the associated account codes determine how those amounts are categorised for reporting and, if applicable, exported to accounting software. This helps businesses align operational data with financial statements and enables accurate allocation of income and expenses.

Sections