Integrate external APIs and services with error handling, retry logic, and data transformation. Use when connecting to payment processors, messaging services, analytics platforms, or other third-party providers.

Third Party Integration Table of Contents [Overview]( overview) [When to Use]( when to use) [Quick Start]( quick start) [Reference Guides]( reference guides) [Best Practices]( best practices) Overview Build robust integrations with external services using standardized patterns for API calls, error handling, authentication, and data transformation. When to Use Integrating payment processors (Stripe, PayPal) Using messaging services (SendGrid, Twilio) Connecting to analytics platforms (Mixpanel, Segment) Syncing with storage services (AWS S3, Google Cloud) Integrating CRM systems (Salesforce, HubSpot) Building multi service architectures Quick Start Minimal working example: Reference Guides Detailed implementations in the references/ directory: Guide Contents [Third Party Client Wrapper](references/third party client wrapper.md) Third Party Client Wrapper [Payment Processor Integration (Stripe)](references/payment processor integration stripe.md) Payment Processor Integration (Stripe) [Email Service Integration (SendGrid)](references/email service integration sendgrid.md) Email Service Integration (SendGrid) [Python Third Party Integration](references/python third party integration.md) Python Third Party Integration [Data Transformation](references/data transformation.md) Data Transformation Best Practices ✅ DO Implement retry logic with exponential backoff Validate webhook signatures Log all API interactions Use environment variables for secrets Transform API responses to internal models Implement circuit breakers for critical services Monitor API quota and rate limits Add proper error handling Use timeouts appropriately Test with sandbox/test API keys ❌ DON'T Hardcode API keys Retry all errors indefinitely Log sensitive data Trust unvalidated webhook data Ignore rate limits Make synchronous blocking calls Expose vendor specific details to clients Skip error handling Use production keys in tests

third-party-integration