SpaceCRM / Blog
SpaceCRM Send API: SpaceCRM Send API Tutorial: Send Your First Transactional Email in 10 Minutes
Hands-on tutorial for integrating SpaceCRM's Send API in Node.js, Python, and PHP — from API key to first successful send.
Getting started
Generate your API key from SpaceCRM Settings → API Keys. Store it in an environment variable — never hardcode in source code.
Base URL: https://api.spacecrm.net/v1. All requests require Authorization: Bearer YOUR_API_KEY header and Content-Type: application/json.
Your first API call
POST /v1/emails with body: { from, to, subject, html }. A 200 response returns { id: 'msg_xxx', status: 'queued' }. Works the same in Python and PHP.
Check spacecrm.net/api for full SDK installation and endpoint reference.
Handling webhook events
Register a webhook endpoint in Settings → Webhooks. You receive POST requests for each event: email.delivered, email.opened, email.bounced, email.complained. Always return 200 within 5 seconds.
Process hard bounces immediately. Suppress complained addresses from all future sends.