REST API Reference · Render25 Docs

Base URL

bash

https://api.render25.com/v1

Authentication

All requests require a bearer token in the Authorization header.

bash

Authorization: Bearer YOUR_API_KEY

Keep your key secret

Never expose API keys in client-side code, browser extensions, or version control. Use environment variables or a secrets manager.

Send Email

POST/email/send

Request Body

Field	Type	Required	Description
`from`	`string`	Required	Sender email address. Must be a verified domain.
`to`	`string \| string[]`	Required	Recipient(s). Maximum 50 addresses per request.
`subject`	`string`	Required	Email subject line.
`html`	`string`	Optional	HTML body content.
`text`	`string`	Optional	Plain-text fallback. Strongly recommended.
`cc`	`string[]`	Optional	Carbon-copy recipients.
`bcc`	`string[]`	Optional	Blind carbon-copy recipients.
`reply_to`	`string`	Optional	Reply-to address.
`headers`	`object`	Optional	Custom email headers as key-value pairs.
`tags`	`string[]`	Optional	Tags for filtering logs. Max 5 per message.
`scheduled_at`	`string (ISO 8601)`	Optional	Schedule delivery for a future time.

Example Request

Send email

curl -X POST https://api.render25.com/v1/email/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Welcome aboard",
    "html": "<h1>Welcome.</h1><p>Your account is ready.</p>",
    "text": "Welcome. Your account is ready.",
    "tags": ["welcome", "onboarding"]
  }'

Response

json

{
  "id": "msg_01J3K9X7YDBTKMR5NXQZG4HWFP",
  "status": "queued",
  "created_at": "2024-09-12T10:42:00Z"
}

List Email Logs

GET/email/logs

bash

curl "https://api.render25.com/v1/email/logs?limit=20&status=delivered" \
  -H "Authorization: Bearer YOUR_API_KEY"

Manage Domains

GET/domains

POST/domains

DELETE/domains/{domain}

Error Codes

HTTP Status	Code	Description
`400`	`invalid_request`	Malformed request body or missing required fields
`401`	`unauthorized`	Missing or invalid API key
`403`	`forbidden`	API key lacks permission for this action
`404`	`not_found`	The requested resource does not exist
`422`	`unprocessable`	Request was valid but could not be processed
`429`	`rate_limited`	Too many requests — see rate limits
`500`	`internal_error`	An unexpected server error occurred