Workflowmax
This directory contains the manifest-only connector for source-workflowmax.
V1 API documentation
Visit https://app.swaggerhub.com/apis-docs/WorkflowMax-BlueRock/WorkflowMax-BlueRock-OpenAPI3/0.1#/ for the V1 API documentation.
Set up authentication
WorkflowMax uses OAuth 2.0. Access tokens expire after 30 minutes, while refresh tokens expire after 60 days. See WorkflowMax authentication docs.
The connector needs your OAuth application’s Client ID, Client Secret and a Refresh Token. It uses these details to obtain new access tokens automatically. A static access token will stop working within 30 minutes.
Get a refresh token using postman
- Register an OAuth 2.0 application in the WorkflowMax developer portal. Note the Client ID and Client Secret.
- Open the Authorization tab of an empty http request and select Oauth 2.0.
- Set use token type as
access token. - Set header prefix as
Bearer. - Set grant type as
Authorization code. - Check
Authorize using browser. - Set Auth URL as
https://oauth.workflowmax2.com/oauth/authorize. - Set Access token URL as
https://oauth.workflowmax2.com/oauth/token. - Set Client ID, Client secret and Scope to match your Workflowmax settings.
- The scope must must include
offline_accessto receive a refresh token. Example Scope:openid profile email workflowmax offline_access. - Set state as any number. Example:
1. - Set Client Authentication as
Send as Basic Auth Header. - Click
Get New Access Token. Copy therefresh_tokenand, optionally, theaccess_tokenfrom the response.
Authorise your source with the required information.
- Go to the set up
The Sourcepage. - Enter your Workflowmax application’s Client ID, Client Secret and Refresh Token. The Access Token field is optional.
- Enter your Account ID and Start date.
- Click Save button.
Configuration
| Input | Type | Description | Default Value |
|---|---|---|---|
client_id | string | Client ID. The Client ID of your WorkflowMax OAuth 2.0 application. | |
client_secret | string | Client Secret. The Client Secret of your WorkflowMax OAuth 2.0 application. | |
refresh_token | string | Refresh Token. OAuth 2.0 refresh token obtained with the offline_access scope; used to refresh the access token automatically. | |
api_key_2 | string | Access Token. Optional - refreshed and stored automatically. | |
account_id | string | Account ID. The account id for workflowmax | |
start_date | string | Start date. |
Streams
| Stream Name | Primary Key | Pagination | Supports Full Sync | Supports Incremental |
|---|---|---|---|---|
| stafflist | UUID | DefaultPaginator | ✅ | ❌ |
| clientlist | UUID | DefaultPaginator | ✅ | ❌ |
| clients_documents | uuid | No pagination | ✅ | ❌ |
| clientgrouplist | UUID | DefaultPaginator | ✅ | ❌ |
| costlist | UUID | DefaultPaginator | ✅ | ❌ |
| invoice_current | UUID | DefaultPaginator | ✅ | ❌ |
| invoicelist | UUID | DefaultPaginator | ✅ | ✅ |
| joblist | UUID | DefaultPaginator | ✅ | ✅ |
| job_tasks | UUID | DefaultPaginator | ✅ | ✅ |
| leadlist | UUID | DefaultPaginator | ✅ | ✅ |
| purchaseorderlist | ID | DefaultPaginator | ✅ | ✅ |
| tasklist | UUID | DefaultPaginator | ✅ | ❌ |
| quotelist | UUID | DefaultPaginator | ✅ | ✅ |
| supplierlist | UUID | DefaultPaginator | ✅ | ❌ |
| timelist | UUID | DefaultPaginator | ✅ | ✅ |
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.0.71 | 2026-11-10 | 90823 | Update dependencies |
| 0.0.70 | 2026-10-27 | 90087 | Update dependencies |
| 0.0.69 | 2026-10-20 | 89492 | Update dependencies |
| 0.0.68 | 2026-10-13 | 88883 | Update dependencies |
| 0.0.67 | 2026-10-07 | 88239 | Fix authentication: refresh the OAuth access token automatically (WorkflowMax access tokens expire after 30 minutes); use the documented pagesize query parameter |
| 0.0.66 | 2026-10-06 | 88119 | Update dependencies |
| 0.0.65 | 2026-09-29 | 87410 | Update dependencies |
| 0.0.64 | 2026-09-22 | 86894 | Update dependencies |
| 0.0.63 | 2026-09-15 | 86285 | Update dependencies |
| 0.0.62 | 2026-09-08 | 85718 | Update dependencies |
| 0.0.61 | 2026-08-18 | 84812 | Update dependencies |
| 0.0.60 | 2026-08-11 | 84193 | Update dependencies |
| 0.0.59 | 2026-08-04 | 83686 | Update dependencies |
| 0.0.58 | 2026-07-28 | 83160 | Update dependencies |
| 0.0.57 | 2026-07-21 | 82652 | Update dependencies |
| 0.0.56 | 2026-07-14 | 82078 | Update dependencies |
| 0.0.55 | 2026-06-30 | 81314 | Update dependencies |
| 0.0.54 | 2026-06-23 | 80710 | Update dependencies |
| 0.0.53 | 2026-06-16 | 80109 | Update dependencies |
| 0.0.52 | 2026-06-09 | 79576 | Update dependencies |
| 0.0.51 | 2026-06-02 | 79088 | Update dependencies |
| 0.0.50 | 2026-04-28 | 77494 | Update dependencies |
| 0.0.49 | 2026-04-21 | 76831 | Update dependencies |
| 0.0.48 | 2026-03-31 | 75862 | Update dependencies |
| 0.0.47 | 2026-03-17 | 75093 | Update dependencies |
| 0.0.46 | 2026-03-03 | 73913 | Update dependencies |
| 0.0.45 | 2026-02-17 | 73530 | Update dependencies |
| 0.0.44 | 2026-02-10 | 72678 | Update dependencies |
| 0.0.43 | 2026-01-20 | 72051 | Update dependencies |
| 0.0.42 | 2026-01-14 | 71459 | Update dependencies |
| 0.0.41 | 2025-12-18 | 70680 | Update dependencies |
| 0.0.40 | 2025-11-25 | 70185 | Update dependencies |
| 0.0.39 | 2025-11-18 | 69638 | Update dependencies |
| 0.0.38 | 2025-10-29 | 68976 | Update dependencies |
| 0.0.37 | 2025-10-21 | 68346 | Update dependencies |
| 0.0.36 | 2025-10-14 | 67955 | Update dependencies |
| 0.0.35 | 2025-10-07 | 67332 | Update dependencies |
| 0.0.34 | 2025-09-30 | 66446 | Update dependencies |
| 0.0.33 | 2025-09-09 | 65691 | Update dependencies |
| 0.0.32 | 2025-08-24 | 65492 | Update dependencies |
| 0.0.31 | 2025-08-10 | 64857 | Update dependencies |
| 0.0.30 | 2025-08-02 | 64340 | Update dependencies |
| 0.0.29 | 2025-07-26 | 64079 | Update dependencies |
| 0.0.28 | 2025-07-19 | 63627 | Update dependencies |
| 0.0.27 | 2025-07-12 | 63226 | Update dependencies |
| 0.0.26 | 2025-07-05 | 62751 | Update dependencies |
| 0.0.25 | 2025-06-28 | 62268 | Update dependencies |
| 0.0.24 | 2025-06-21 | 61750 | Update dependencies |
| 0.0.23 | 2025-06-15 | 61212 | Update dependencies |
| 0.0.22 | 2025-05-24 | 60748 | Update dependencies |
| 0.0.21 | 2025-05-10 | 59972 | Update dependencies |
| 0.0.20 | 2025-05-04 | 59550 | Update dependencies |
| 0.0.19 | 2025-04-26 | 58938 | Update dependencies |
| 0.0.18 | 2025-04-19 | 58544 | Update dependencies |
| 0.0.17 | 2025-04-12 | 58027 | Update dependencies |
| 0.0.16 | 2025-04-05 | 57381 | Update dependencies |
| 0.0.15 | 2025-03-29 | 56876 | Update dependencies |
| 0.0.14 | 2025-03-22 | 56313 | Update dependencies |
| 0.0.13 | 2025-03-08 | 55583 | Update dependencies |
| 0.0.12 | 2025-03-01 | 55141 | Update dependencies |
| 0.0.11 | 2025-02-22 | 54523 | Update dependencies |
| 0.0.10 | 2025-02-15 | 53526 | Update dependencies |
| 0.0.9 | 2025-02-01 | 53070 | Update dependencies |
| 0.0.8 | 2025-01-25 | 52441 | Update dependencies |
| 0.0.7 | 2025-01-18 | 51947 | Update dependencies |
| 0.0.6 | 2025-01-11 | 51422 | Update dependencies |
| 0.0.5 | 2024-12-28 | 50782 | Update dependencies |
| 0.0.4 | 2024-12-21 | 50324 | Update dependencies |
| 0.0.3 | 2024-12-14 | 47888 | Update dependencies |
| 0.0.2 | 2024-10-28 | 47527 | Update dependencies |
| 0.0.1 | 2024-10-13 | 46866 | Initial release by @btkcodedev via Connector Builder |