SDKs

Overview

Freesend provides official SDKs for multiple programming languages to make integrating with our email API as simple as possible. Each SDK is designed following the language's best practices and conventions while providing a consistent API experience across platforms.

Available SDKs

✅ Available Now

• JavaScript/TypeScript - Full TypeScript support, Node.js & browser compatibility
  • Modern, type-safe interface
  • Comprehensive error handling
  • Attachment support (base64 and URL-based)
  • Browser and Node.js environments

🚧 Coming Soon

• Python
• Go
• PHP
• Ruby

Why Use an SDK?

Using an official SDK provides several advantages over making direct HTTP requests:

Simplified Integration

• No need to handle HTTP requests manually
• Built-in error handling and validation
• Automatic retry logic and rate limiting

Type Safety

• Full TypeScript/IntelliSense support
• Compile-time error checking
• Auto-completion in your IDE

Best Practices

• Follows language conventions
• Handles edge cases automatically
• Built-in security features

Maintenance

• Automatic updates and bug fixes
• Backward compatibility guarantees
• Community support and documentation

Common Features

All Freesend SDKs provide:

• Authentication - Simple API key-based authentication
• Email Sending - Send emails with HTML, text, and attachments
• Error Handling - Comprehensive error types and messages
• Validation - Input validation and sanitization
• Documentation - Extensive examples and API reference

Getting Started

Choose your preferred programming language from the list above and follow the specific installation and usage instructions. Each SDK includes:

• Quick start guide
• Installation instructions
• Code examples
• API reference
• Best practices
• Error handling guide

API Compatibility

All SDKs are built on top of the same REST API, ensuring:

• Consistent behavior across languages
• Same rate limits and quotas
• Identical feature sets
• Unified error codes and messages

Community & Support

• Documentation: Comprehensive guides for each SDK
• Examples: Real-world usage examples and templates
• GitHub: Open source repositories with issue tracking
• Discussions: Community support and feature requests

Contributing

We welcome contributions to our SDKs! Each SDK repository is open source and accepts:

• Bug reports and feature requests
• Code contributions and improvements
• Documentation updates
• Example code and tutorials

Visit the individual SDK repositories to get involved in development.