RadarSend API
Manage contacts, send email, run automations, and read reports from your own code. It’s a REST API with JSON in and out, authenticated with an API key.
- Base URL
- https://api.radarsend.com
- Authentication
- X-API-Key header
- Version
- v1.0.0
curl -X GET "https://api.radarsend.com/t/acme/api/contacts" \
-H "X-API-Key: $RADARSEND_API_KEY"Start here
- Authentication API keys, the radar_ format, and the X-API-Key header.
- Scopes & access planning Choosing the narrowest scope set for an integration.
- Errors & rate limits The error envelope, common codes, and rate-limit headers.
- Lists & pagination The one shape every list endpoint returns, and how to page through it.
Endpoints
Contacts 14 endpoints Custom fields 4 endpoints Lists & segments 12 endpoints Suppression 4 endpoints Reference data 3 endpoints Broadcasts 16 endpoints Email library 10 endpoints Templates 22 endpoints Sequences 4 endpoints Seed lists 4 endpoints Events 1 endpoint Reporting 3 endpoints Forms 3 endpoints
Guides
Getting started
- AuthenticationAPI keys, the radar_ format, and the X-API-Key header.
- Scopes & access planningChoosing the narrowest scope set for an integration.
- Errors & rate limitsThe error envelope, common codes, and rate-limit headers.
- Lists & paginationThe one shape every list endpoint returns, and how to page through it.
- Versioning & compatibilityWhat can change without warning, what cannot, and how a breaking change would reach you.
- ChangelogEvery change to the API surface, newest first.
Contacts & audience
- ContactsCreate, upsert, search, bulk-update and export contacts.
- Custom fieldsRead the typed schema contact values live in.
- EventsRecording custom events from your backend.
- Lists & segmentsStatic lists and dynamic segments, and their membership.
- SuppressionHard-blocking an address, and how it differs from unsubscribing.
Sending
- Sending setupSending identities, domains and providers.
- Reference dataEmail types, sending identities, segments and templates by public key.
- BroadcastsDraft, schedule and control a one-off send.
- Email libraryReusable emails with immutable version history.
- Template modeParameters, sections, slots and blocks for dynamic content.
- Template import/exportRound-trip templates and blocks as markdown.
- SequencesDiscover automated flows and enrol contacts into them.
- Seed listsKeep a deliverability vendor's seed mailboxes current from a script or automation.
Setting RadarSend up rather than building on it? Go to the guides →