SECURITY & INTEGRATION GUIDANCE
Connect securely. Understand every trust boundary.
Use this guidance to plan access, protect credentials, validate events and handle sensitive data.

Your role
What brings you here?
Pick a role to see a suggested reading order. Nothing is personalized or stored.
Developer — Build and test an integration
Before you connect
Prepare before requesting access
This checklist is preparation — not an attestation or approval.

Shared responsibility
Who protects what
Access
Authentication, permissions and consent

Authentication
Authentication patterns are published per operation in the API reference.

Permissions and consent
- Request only the scopes you need
- Organization approval is recorded per scope
- Consent status comes from its owning system
- Revoke access you no longer use
Secrets
Handle credentials safely
Masking a value on screen isn't the same as storing it securely.
Store
In a secrets manager — never in code, repos or browser storage
Reveal once
Where designed, a secret is shown once; copy it straight to secure storage
Rotate
Rotating may interrupt integrations using the previous credential. Review affected applications.
Revoke
Immediately, if exposure is suspected
Check text before you share it
Paste a log line or message you're about to send to support. This check runs only in your browser — nothing is sent or stored.

Local check only. It can miss secrets — always review manually.
Transport, environments & webhooks
Protect every connection
Separate environments
Keep non-production and production credentials, data and callbacks apart. Test actions must never reach unapproved production resources.
Protected transport
Use HTTPS and validate the host you connect to. Specific protocol and cipher requirements are confirmed by engineering before publication.
Webhook messages
Verify signatures before processing and bound replay windows, following the exact published version.
Sensitive data
Collect less, keep it shorter

Minimize
Request only fields your approved purpose needs.
Mask
Show partial values where full values aren't needed.
Protect
Encrypt stored sensitive data with managed keys.
Retain
Retention periods aren't yet confirmed for publication — follow your agreement.
Delete
Delete on schedule and when access ends.
Examples
Safe example pattern

Troubleshooting
What did you see?
Choose the response you received. Remediation depends on the actual API contract for the operation.
Report a concern
Report a suspected vulnerability
Report a suspected vulnerability through the approved private security channel. Share the minimum evidence needed, and don't disclose it publicly while it's being reviewed.

FAQ
