Limit access and protect sensitive information
Apps should receive only the scopes required for their work. A connector that creates Donation records should not automatically receive permission to publish pages, read confidential program fields, or archive unrelated CRM information.
Before transferring sensitive data, confirm that HubSpot is an appropriate destination, the source permits the transfer, required Sensitive Data functionality and scopes are available, access is restricted, retention obligations are documented, and confidential values will not appear in URLs, logs, webhook archives, or debugging messages.
Treat the integration as an operational system
HubSpot applies API limits that can vary by app type, authorization, endpoint, account, subscription, version, interval, and batch size. A dependable integration should use batches appropriately, respect rate-limit responses, queue large jobs, retry temporary failures safely, alert an owner when synchronization falls behind, and avoid exposing sensitive information in logs.
API versions and capabilities also change. Assign responsibility for monitoring announcements, reviewing deprecations, updating versions and scopes, rotating credentials, testing changes, maintaining hosting, responding to failures, and documenting the integration.
Questions to answer before building
- Which process should improve?
- Which systems are involved?
- What system owns each value?
- Which records and associations are required?
- What prevents duplicates?
- What starts the process?
- Is synchronization one-way or bidirectional?
- Which scopes are required?
- What requires staff approval?
- What happens after a partial failure?
- Where are errors recorded?
- Who owns ongoing maintenance?