CS
CloudSend
Ultra-Low Cost AWS Serverless Architecture

CloudSend Platform Documentation

Welcome to the comprehensive technical documentation for CloudSend. CloudSend combines an Audience CRM, Dynamic Email Campaign Studio, Engagement Telemetry, Ephemeral File Transfer, and Model Context Protocol (MCP) AI Service into a unified, serverless engine with zero third-party runtime dependencies.

Structured Documentation Sections
START HERE
01

Platform User Guide

Step-by-step walkthroughs of using every part: Contacts CRM, Visual Email Studio, SES Campaigns, Telemetry, and Secure Transfers.

Explore guides →
02

Getting Started & Setup

Configure workspace accounts, member roles, subscription tiers, and setup custom sending domains with DKIM, SPF, and DMARC DNS records.

Setup guide →
03

API Setup & Bearer Tokens

Learn the authentication lifecycle, obtain Bearer JWTs, resolve workspace account headers, and use automated token scripts.

Auth guide →
04

REST API Reference & Sandbox

Complete breakdown of every API endpoint with multi-language code snippets in cURL, JavaScript, Python, PHP, and Go plus live sandbox execution.

API breakdown →
05

Model Context Protocol (MCP)

Integrate AI assistants like Claude Desktop, Cursor, and Windsurf using 13 native MCP tools, stdio runners, and JSON-RPC 2.0 endpoints.

MCP documentation →
Platform Architecture Principles
Ultra-Low Cost AWS Serverless

Single S3 bucket partitioned for private state (state/accounts/*) and ephemeral payloads (transfers/*). ARM64 Node.js 20 Lambda Function URLs and CloudFront edge CDN with sub-$1.00/mo idle cost.

AES-256-GCM Cryptographic Isolation

Sensitive records are encrypted using native AES-256-GCM with Authenticated Additional Data (AAD) cryptographically bound to the workspace ID, preventing cross-tenant leakage even if data is extracted out of band.

Zero Third-Party Runtime Dependencies

Backend runs 100% on Node.js 20 built-ins (node:crypto, node:fs, node:http) and pre-installed AWS SDK clients, eliminating npm supply-chain vulnerabilities entirely.

Campaign Segmentation

CloudSend Segment Query Language (CSQL) & AI Assistant

CSQL is CloudSend's native boolean query language for segmenting CRM contacts in the Campaign Builder and REST API. It supports boolean logic (AND, OR, NOT, (...)), comparisons (=, !=, >, >=, <, <=), sets (IN, NOT IN), ranges (BETWEEN a AND b), string matching (CONTAINS, STARTS_WITH, ENDS_WITH, LIKE), and presence (EXISTS, IS NULL).

Example Contact Queries
country IN ("US", "UK", "DE") AND company EXISTS
score >= 80 AND (tags = "vip" OR group = "vip")
role = "CTO" AND industry = "FinTech"
email NOT ENDS_WITH "@gmail.com"
score BETWEEN 60 AND 89 AND marketingStatus = "subscribed"
Built-in & Contact Attribute Fields
  • email, id, marketingStatus, createdAt, updatedAt
  • group (e.g. group = "vip"), group.<id>.marketing
  • gdpr.status, gdpr.lawfulBasis, consent.*
  • <attributeKey> (custom contact attributes e.g. country, company, role, score, tags)