> ## Documentation Index > Fetch the complete documentation index at: https://docs.transmit.dev/llms.txt > Use this file to discover all available pages before exploring further. # Post v1emails > Send a transactional or broadcast email. Starts a durable workflow for email delivery with retry guarantees. ## OpenAPI ````yaml https://api.transmit.dev/openapi.json post /v1/emails openapi: 3.1.0 info: title: Transmit.dev API description: >- A powerful email API for transactional and marketing emails. Send emails with tracking, analytics, and webhook support. version: 1.0.3 servers: - url: https://api.transmit.dev description: Production server security: - bearerAuth: [] tags: - name: Emails description: Email sending and management operations - name: SMS description: SMS sending and management operations with toll-free numbers - name: Analytics description: Performance analytics and metrics - name: Billing description: Credit balance and usage information - name: Contacts description: Contact management operations - name: Webhooks description: Webhook configuration and testing paths: /v1/emails: post: tags: - Emails description: >- Send a transactional or broadcast email. Starts a durable workflow for email delivery with retry guarantees. operationId: send requestBody: required: true content: application/json: schema: type: object properties: from: type: string minLength: 1 pattern: ^.+@.+\..+$ from_name: type: string reply_to: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ to: anyOf: - type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: array items: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ cc: anyOf: - type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: array items: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ bcc: anyOf: - type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: array items: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ subject: type: string minLength: 1 html: type: string text: type: string template_id: type: string template_friendly_name: type: string variables: type: object propertyNames: type: string additionalProperties: type: string tags: type: array items: type: string headers: type: object propertyNames: type: string additionalProperties: type: string attachments: type: array items: type: object properties: filename: type: string content: type: string type: type: string disposition: type: string enum: - attachment - inline contentId: type: string required: - filename - content - type scheduled_for: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ batch_id: type: string message_stream: type: string enum: - transactional - broadcast track_opens: type: boolean track_clicks: type: boolean required: - from - to responses: '202': description: >- Email accepted for processing. Email record created and workflow started. content: application/json: schema: type: object properties: id: type: string description: Email ID (Resend-compatible) workflow_id: description: Workflow ID for tracking durable execution (debugging) type: string from: type: string minLength: 1 description: >- Sender address. Supports optional display name (e.g. 'Sender Name '). to: type: array items: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ description: Recipient email addresses subject: type: string description: Email subject created_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ description: Creation timestamp scheduled_for: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' description: Scheduled delivery time suppressed_recipients: type: array items: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ description: Recipients that were suppressed status: type: string const: processing description: Email processing status required: - id - from - to - subject - created_at - scheduled_for - suppressed_recipients - status '400': description: Bad request - all recipients suppressed content: application/json: schema: type: object properties: code: type: string description: Error code message: type: string description: Error message statusCode: type: number description: HTTP status code details: description: Additional error details required: - code - message - statusCode '401': description: Authentication required content: application/json: schema: type: object properties: code: type: string description: Error code message: type: string description: Error message statusCode: type: number description: HTTP status code details: description: Additional error details required: - code - message - statusCode '422': description: Validation error - domain not verified or invalid email format content: application/json: schema: type: object properties: code: type: string description: Error code message: type: string description: Error message statusCode: type: number description: HTTP status code details: description: Additional error details required: - code - message - statusCode '429': description: Rate limit exceeded or insufficient credits content: application/json: schema: type: object properties: code: type: string description: Error code message: type: string description: Error message statusCode: type: number description: HTTP status code details: description: Additional error details required: - code - message - statusCode '500': description: Internal server error content: application/json: schema: type: object properties: code: type: string description: Error code message: type: string description: Error message statusCode: type: number description: HTTP status code details: description: Additional error details required: - code - message - statusCode components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Enter your API key with 'tx_' prefix. Get your API key from the dashboard. ````