API Usage
Respect Rate Limits
Implement exponential backoff when you hit rate limits. Cache responses when possible to reduce API calls.
Handle Pagination
Use the page-based pagination (
page and per_page parameters) for large result sets. Don’t request more data than you need.Secure Token Storage
Store access tokens and refresh tokens securely. Never log tokens or expose them in client-side code.
Webhook Handling
1
Respond quickly
Return a 2xx response within 5 seconds. Queue processing for later if needed.
2
Implement idempotency
Store webhook IDs to handle duplicate deliveries gracefully.
3
Verify signatures
Always validate webhook signatures before processing payloads.
4
Handle failures
Log failed processing and implement retry mechanisms.
Error Handling
User Experience
- Clear onboarding — Guide users through setup with clear instructions and progress indicators.
- Helpful error messages — Show actionable error messages that help users resolve issues.
- Sync status — Show sync status and last successful sync time.
- Easy disconnection — Provide a clear way for users to disconnect your app.
Next Steps
App Guidelines
Review listing requirements.
Submit for Review
Get your app approved.