> ## Documentation Index > Fetch the complete documentation index at: https://docs.lumisreach.com/llms.txt > Use this file to discover all available pages before exploring further. # Send a Quick Email > Sends one plain-text email to up to 20 recipients (each gets an individual copy). Each `to` entry is an email address or the name of a contact in the workspace, matched case-insensitively with small typos tolerated, whose email on file is used; a name that matches no one returns 404, and one that could be two people returns 422 listing the candidates. It goes out from a shared LumisReach address, shown as " via LumisReach". No sending domain is required. Replies go to `reply_to`, defaulting to the email of the user who owns the API key. Recipients on the workspace's suppression list (unsubscribes, bounces) are skipped and reported in `suppressed`. Limited to 200 recipients per workspace per rolling 24 hours (409 past it); for bulk or marketing email use your own verified domain. Billing: $0.01 per recipient sent to, charged to the wallet of the organization that owns the API key; 403 when the wallet cannot cover it. ## OpenAPI ````yaml /openapi.json post /v1/quick/emails openapi: 3.1.0 info: title: LumisReach v1 API version: 1.0.0 description: >- Programmatic access to the LumisReach voice platform — calls, numbers, caller trust, and brands. contact: name: LumisReach email: founders@lumisreach.com servers: - url: https://api.lumisreach.com/api security: - bearerAuth: [] tags: - name: Contacts - name: Calls - name: Messages - name: Emails - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Dialer Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Billing - name: Documents - name: Lincoln AI - name: Quick Agent Actions - name: Sub-entities - name: Video schedules - name: Videos paths: /v1/quick/emails: post: tags: - Quick Agent Actions summary: Send a Quick Email description: >- Sends one plain-text email to up to 20 recipients (each gets an individual copy). Each `to` entry is an email address or the name of a contact in the workspace, matched case-insensitively with small typos tolerated, whose email on file is used; a name that matches no one returns 404, and one that could be two people returns 422 listing the candidates. It goes out from a shared LumisReach address, shown as " via LumisReach". No sending domain is required. Replies go to `reply_to`, defaulting to the email of the user who owns the API key. Recipients on the workspace's suppression list (unsubscribes, bounces) are skipped and reported in `suppressed`. Limited to 200 recipients per workspace per rolling 24 hours (409 past it); for bulk or marketing email use your own verified domain. Billing: $0.01 per recipient sent to, charged to the wallet of the organization that owns the API key; 403 when the wallet cannot cover it. operationId: v1_quick_emails_post parameters: - name: Idempotency-Key in: header required: false description: >- A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency. schema: type: string requestBody: required: true content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: to: minItems: 1 maxItems: 20 type: array items: type: string minLength: 1 maxLength: 254 description: >- Recipients: email addresses and/or names of contacts in the workspace (case-insensitive, small typos are fine; the contact's email on file is used). Each gets an individual copy; they do not see each other subject: type: string minLength: 1 maxLength: 200 body: type: string minLength: 1 maxLength: 20000 reply_to: type: string maxLength: 254 pattern: ^[^\s@<>(),;:"]+@[^\s@<>(),;:"]+\.[a-z]{2,}$ from_name: type: string minLength: 1 maxLength: 60 required: - to - subject - body additionalProperties: false responses: '200': description: Success content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: data: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ kind: type: string const: email status: type: string const: sent from: type: string reply_to: type: - string - 'null' sent_to: type: array items: type: string suppressed: type: array items: type: string recipients: type: array items: type: object properties: input: type: string email: type: string contact_id: type: - string - 'null' contact_name: type: - string - 'null' required: - input - email - contact_id - contact_name additionalProperties: false cost_usd: type: number pricing: type: object properties: per_recipient_usd: type: number note: type: string required: - per_recipient_usd - note additionalProperties: false required: - id - kind - status - from - reply_to - sent_to - suppressed - recipients - cost_usd - pricing additionalProperties: false required: - data additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer ````