API & integration issues
Troubleshooting engagement tracking issues:
Common Issues:
Click tracking domain misconfiguration
SSL certificate problems
CNAME record issues
Tracking domain validation errors
Verification Steps:
Check tracking domain setup
Verify CNAME records
Validate SSL certificates
Test tracking links
Resolution Steps:
Review tracking domain settings in UI
Update DNS records if needed
Verify tracking domain validation
Check for any system status notifications
Best Practices:
Regular tracking domain validation
Monitor engagement metrics
Set up backup tracking domains
Keep SSL certificates current
For persistent tracking issues, check the status page and contact support with specific error messages and affected tracking domains.
Why am I getting permissions-related errors when my API key has correct permissions?
Troubleshoot permission errors:
Common Causes:
API key scope mismatch
Account access level restrictions
Incorrect permission combinations
Recently changed permissions not yet propagated
In case of multiple accounts, verify that the API key corresponds to the right account
Resolution Steps:
Double-check API key permissions in UI
Verify each required permission is explicitly granted
Ensure permissions match endpoint requirements
Create new API key if permissions recently changed
Why am I getting errors when trying to make API calls?
Common causes and solutions for API errors:
Authentication Issues:
Verify API key format and validity
Check API key is being passed correctly in headers
Ensure API key hasn't expired
Confirm proper Authorization header format (Authorization: <API_KEY>)
Rate Limiting:
Watch for 429 status codes
Implement proper retry logic
Space out requests appropriately
Consider upgrading plan if consistently hitting limits
Request Format:
Validate JSON syntax
Check required fields are present
Ensure proper content-type headers
Verify endpoint URLs are correct
