Why This Matters
APIs let you connect SubcontractorHub with your other business tools and automate data transfers. Even if you're not a developer yourself, understanding what's possible helps you work with your tech team to build powerful, time-saving integrations.
What You'll Need
Your SubcontractorHub API key (found in Settings → API)
A developer or tech-savvy team member to help with setup
A tool like Postman (free) to test API calls
How It Works
Public URL:https://api.virtualsaleportal.com/api/public/v2/get-custom-fields/project/{:uniqueId}(GET)Note:The unique_id can be subhub_id or external_id. Example Response:{ " subhub_id": 5083, " fields": [ { " label": "Contract Approved", " field_key": " m1_approved_date", " type": " date_time", " value": "2024-02-02T21:00:38.000Z" }, { " label": "NEM Paid invoice", " field_key":
" nem_paid_invoice", " type": " file", " value": [ " https://stp-sales-tool.s3.us-west-2.amazonaws.com/projects/5083/jljENPHsAm CdB3l89CemZ14LegCBRUJV9njAfJO3.pdf" ] }, ] }Related ArticlesV2 API: Get Project Custom FieldsV2 API: Update Custom Fields of Project (Input of stages)V2 API: Get Single Project
Detail
Key Points for Your Developer
Always include your API key in the request header
Test with a single record before running bulk operations
Log all API responses for troubleshooting
Pro Tips
💡 Start small: Test with one record before running bulk operations.
💡 Keep your API key safe: Never share it in emails or public repos.
💡 Log everything: Have your developer log responses for easy troubleshooting.
Troubleshooting
Problem | Solution |
Page won't load | Clear your browser cache and try again in Chrome or Edge |
Settings not saving | Make sure you have Admin access and click Save after each change |
Feature not visible | Check with your account manager to confirm your plan includes this feature |
Change Log
Date | Change |
2026-05-19 | Article rewritten for clarity and contractor-friendly tone |
Split Analysis: This article covers a single focused topic and does not require splitting into sub-articles.