> ## Documentation Index > Fetch the complete documentation index at: https://docs.tented.ai/llms.txt > Use this file to discover all available pages before exploring further. # Send a blast now > Start the send immediately (asynchronous). Same readiness requirements as scheduling. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/email-blasts/{blastId}/send-now openapi: 3.1.0 info: title: Tented API version: 1.0.0 description: >- The Tented public API: generate, publish, and manage AI-built web pages (tents), and run the email platform — contacts, reusable emails, one-time blasts, and triggered flows. ## Authentication Authenticate every request with a workspace API key: `Authorization: Bearer `. Keys are created in **Workspace Settings → API Keys** and are scoped to a single workspace. ## Asynchronous work Tent generation, bulk creation, and email AI generation return `202 Accepted` immediately. Poll the corresponding status endpoint (`GET /v1/tents/{tentId}`, `GET /v1/bulk-jobs/{bulkJobId}`, `GET /v1/emails/{emailId}/generations/{generationId}`) — no more than every 10 seconds. ## Pagination Email listings use cursor pagination (`cursor`/`next_cursor`). Blast, flow, and member listings use page pagination (`page`/`limit` with a `pagination` object in the response). ## Conventions Request and response fields are snake_case, with two exceptions: analytics query parameters (`tentIdOrAlias`, `daysBack`) and segment rule trees (camelCase keys such as `listId` and `timeWindow`). contact: name: Tented Support email: support@tented.ai servers: - url: https://api.tented.ai description: Production security: - bearerAuth: [] tags: - name: Tents description: >- Create, edit, publish, and manage AI-generated pages, including asset uploads and bulk creation. - name: Analytics description: Traffic analytics for single tents and the whole workspace. - name: Contacts description: >- Batch create, update, and delete contacts. Up to 25 items per request with per-item results. - name: Emails description: >- Reusable email content: AI generation, direct HTML edits, plain-text control, and approval. - name: Email Blasts description: >- One-time sends to an audience: compose, schedule, track engagement, export recipients. - name: Triggered Flows description: >- Multi-step automations that enroll contacts on triggers and move them through a step graph. - name: Contact Imports - name: Contact Fields - name: Contact Lists - name: Email Templates - name: Tent Templates description: >- Reusable, AI-editable tent layouts. Create from HTML or an existing tent, iterate with AI, approve, and clone. Approved tent templates seed new tents. paths: /v1/email-blasts/{blastId}/send-now: post: tags: - Email Blasts summary: Send a blast now description: >- Start the send immediately (asynchronous). Same readiness requirements as scheduling. operationId: send-blast-now parameters: - name: blastId in: path required: true schema: type: string format: uuid description: Blast ID. requestBody: required: true content: application/json: schema: type: object properties: operational: type: boolean description: Send as operational/transactional. Default `false`. responses: '202': description: Send started. content: application/json: schema: $ref: '#/components/schemas/Blast' '400': description: >- Bad request — invalid parameters or request body. Validation failures include `details.issues` with per-field messages. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized — missing, malformed, revoked, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- Not found — the resource does not exist in the workspace tied to your API key. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Conflict — see `error_code` for the specific reason. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Blast: type: object properties: blast_id: type: string format: uuid description: Blast ID. type: type: string description: Always `email_blast`. name: type: string description: Blast name. description: type: - string - 'null' description: Description. status: type: string enum: - draft - scheduled - sending - sent - failed - cancelled - archived description: Lifecycle state. audience_list_id: type: - string - 'null' description: List backing the audience. audience_source: type: - string - 'null' description: '`existing` or `inline`.' audience: type: - object - 'null' properties: list_id: type: string format: uuid description: List ID. source: type: string description: '`existing` or `inline`.' name: type: string description: List name. kind: type: string description: '`static` or `dynamic`.' member_count: type: integer description: Current member count. description: Attached audience, or `null` when not set. email_id: type: - string - 'null' description: Email attached to the blast. email_source: type: - string - 'null' description: '`existing` or `inline`.' email: type: - object - 'null' properties: email_id: type: string format: uuid description: Email ID. source: type: string description: '`existing` or `inline`.' name: type: string description: Email name. status: type: string description: '`draft` or `approved`.' subject: type: - string - 'null' description: Subject line. current_version: type: integer description: Latest version. approved_version: type: - integer - 'null' description: Approved version, or `null`. description: Attached email summary, or `null` when not set. operational: type: boolean description: >- True for operational/transactional sends: unsubscribed contacts are not suppressed and the unsubscribe footer is skipped. scheduled_at: type: - string - 'null' format: date-time description: Scheduled send time (UTC). approved_at: type: - string - 'null' format: date-time description: When the attached email was approved for this blast. approved_email_version: type: - integer - 'null' description: Email version locked in for the send. sent_at: type: - string - 'null' format: date-time description: When the send completed. send_mode: type: - string - 'null' description: '`scheduled` or `send_now`.' details: $ref: '#/components/schemas/BlastDetails' approval_readiness: $ref: '#/components/schemas/ApprovalReadiness' created_at: type: string format: date-time description: Creation time. updated_at: type: string format: date-time description: Last update. required: - blast_id - type - name - status description: >- An email blast. `approval_readiness` is included only while the blast is a draft. Error: type: object properties: error: type: string description: Human-readable error message. error_code: type: string description: >- Stable machine-readable error code (present on email, blast, flow, and related endpoints, e.g. `campaign_not_ready`, `generation_in_progress`). message: type: string description: Additional human-readable context (present on some tent endpoints). code: type: string description: >- Machine-readable code used by tent creation errors (e.g. `INVALID_PROMPT_INTENT`). details: type: object additionalProperties: true description: >- Additional error context. Validation errors include `issues`: an array of `{ path, message }` objects. limit: type: integer description: Plan limit that was hit (present on `429` publish-limit errors). current: type: integer description: >- Current usage against the limit (present on `429` publish-limit errors). required: - error description: >- Error response. All errors include `error`; the other fields vary by endpoint group. BlastDetails: type: object properties: blast_recipient_count: type: integer description: Contacts targeted. blast_qualified_count: type: integer description: Contacts that qualified at send time. blast_sent_count: type: integer description: Messages sent. blast_failed_count: type: integer description: Messages that failed to send. blast_blocked_count: type: integer description: Contacts suppressed (e.g. unsubscribed). blast_audience_truncated: type: boolean description: Whether the audience was truncated. blast_delivered_count: type: integer description: Messages delivered. blast_opened_count: type: integer description: Unique opens. blast_clicked_count: type: integer description: Unique clicks. blast_bounced_count: type: integer description: Bounces. blast_spam_count: type: integer description: Spam complaints. blast_unsubscribed_count: type: integer description: Unsubscribes attributed to the blast. description: Send and engagement counters. ApprovalReadiness: type: object properties: ready: type: boolean description: Whether the blast can be scheduled or sent. missing: type: array items: type: string description: Blocking requirements, e.g. `email_approval`, `schedule`. warnings: type: array items: type: string description: Non-blocking issues, e.g. `empty_static_audience`. description: >- Readiness summary included on draft blasts and on `campaign_not_ready` errors. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Workspace API key, e.g. `Authorization: Bearer tented_...`. Create keys in Workspace Settings → API Keys. ````