Email API (1.0.0)

Download OpenAPI specification:

API for sending emails with optional attachments, templates, and other metadata.

API Versioning

This API uses versioned endpoints. All endpoints must include the version in the URL path (e.g., /v1/email/send).

Authentication

All requests require a valid API key passed in the Authorization header as a Bearer token.

Limits

  • Maximum message size: 50MB
  • Maximum recipients per email: 1000
  • Maximum webhook data keys: 10
  • Maximum tag length: 100 characters
  • Maximum send time in future: 72 hours

Get supported API versions

Returns information about supported API versions and the current version

Responses

Request samples

curl --request GET \
  --url https://custom_endpoint.send.laneful.net/v1/versions

Response samples

Content type
application/json
{
  • "supported_versions": [
    ],
  • "current_version": "v1"
}

Send an email or a batch of emails

Send one or more emails. The API accepts the request and queues the emails for sending. Returns immediately with an "accepted" status.

Authorizations:
bearerAuth
Request Body schema: application/json
required

List of emails to send

Array of objects (Email)
Default: []

List of emails to send. Cannot be empty.

Responses

Request samples

Content type
application/json
Example
{
  • "emails": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "accepted"
}