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/update-custom-fields/project(PUT)Note: unique_id can be subhub_id or external_id. Example Payload:{ " unique_id": "EXY-10231345", " fields": [ { " field_key": " pto_notes", " value": "Updated Note" } ] }OR update a single field:{ " unique_id": "EXY-10231345", " fields": {
" field_key": " pto_notes", " value": "Updated Note" } }Related ArticlesHow to Update Project Stages?V2 API: Get Project Custom FieldsV2 API: Get Custom Fields With Values As Per ProjectCreate Customer APIV2 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.