> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sapt.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Send email via AWS SES
> Send transactional emails with automatic tracking. All emails are tracked in the Sapt admin dashboard with delivery, open, and click tracking.
## OpenAPI
````yaml https://api.sapt.ai/openapi.json post /emails/send/send
openapi: 3.1.0
info:
title: Sapt Platform API
version: 1.0.0
description: >-
API for Sapt platform - project management, authentication, and email
services
servers:
- url: https://api.sapt.ai
description: Production
- url: http://localhost:8787
description: Local development
security: []
tags:
- name: Accounts
description: >-
The social accounts connected to a project. Start here — the `id` of an
account is the `socialAccountId` that every posting, scheduling and
analytics call takes.
- name: Actions
- name: Ads
- name: Agents
- name: Analytics
description: >-
Account- and post-level organic performance for connected Instagram and
Facebook accounts.
- name: Assets
- name: Auth
- name: CMS
- name: CRM
- name: Calendar
- name: Comments
description: >-
Read, reply to, hide and delete comments on published Instagram and
Facebook posts.
- name: Content Calendar
description: >-
Create, schedule, update and publish organic posts, and stage the media
they carry. Publishing a post whose status is `failed` retries it.
- name: Contracts
- name: Conversions
description: >-
Meta server-side Conversions API (CAPI): discover pixels, connect a pixel
+ CAPI token, and send deduped server-side conversions.
- name: Dashboard Sidebar
- name: Emails
- name: Engagement
description: >-
Act as the Page or account on published posts: comment, like, unlike, and
delete a published post.
- name: Geo
- name: Google Ads
- name: Google Analytics
- name: Google Business
- name: Integrations
description: >-
Connect third-party providers (Meta, Gmail, Google Business Profile, …).
List providers, mint OAuth connect links, and poll connection status.
- name: Invitations
- name: Memory
- name: OAuth Clients
- name: Project Roles
- name: Project Templates
- name: Projects
- name: Schedules
- name: Service Accounts
- name: Socials
description: >-
Organic social: the connected accounts, the content calendar, media
staging, publishing, comments and engagement across Instagram, Facebook,
TikTok, YouTube and Google Business Profile.
- name: Team
- name: Users
- name: Web Analytics
- name: Workflows
paths:
/emails/send/send:
post:
tags:
- Emails
summary: Send email via AWS SES
description: >-
Send transactional emails with automatic tracking. All emails are
tracked in the Sapt admin dashboard with delivery, open, and click
tracking.
operationId: send
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
to:
type: string
format: email
example: user@example.com
description: Recipient email address
subject:
type: string
minLength: 1
maxLength: 200
example: Welcome to our service
description: Email subject line (max 200 characters)
html:
type: string
minLength: 1
maxLength: 500000
example: >-
Hello!
Welcome to our
service.
description: HTML email content (max 500KB)
text:
type: string
maxLength: 100000
example: Hello! Welcome to our service.
description: Plain text fallback (max 100KB, optional)
replyTo:
type: string
format: email
example: support@example.com
description: Reply-to email address (optional)
metadata:
type: object
additionalProperties: {}
example:
inquiryId: 123
type: contact-inquiry
description: Additional metadata for tracking (optional)
required:
- to
- subject
- html
responses:
'200':
description: Email sent successfully
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
messageId:
type: string
required:
- success
- messageId
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error message
code:
type: string
description: Error code for programmatic handling
required:
- message
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
JWT token obtained from /api/auth/token endpoint. Token is verified
using JWKS and must include a valid user identifier.
````