> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wazobiamail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Check email spam and deliverability score

> Evaluate an email draft for spam indicators, deceptive links, HTML hygiene, and compliance before sending. This feature is restricted to accounts on the Business plan and above (active or trialing Business or Enterprise subscription, plus platform administrators). Accounts on Free, Starter, or Pay-as-you-go receive 403 Forbidden.



## OpenAPI

````yaml /customer-openapi.json post /sending/spam-check
openapi: 3.1.0
info:
  title: WazobiaMail API
  version: 1.0.0
  description: >-
    Customer-facing WazobiaMail API. Base URL
    https://app.wazobiamail.com/api/v1. Every response uses the {success,
    message, data} envelope. This specification covers the integration API:
    API-key and public operations. Sign-in, registration, password reset and
    account settings are supported in the app and are not listed here, although
    a dashboard key can call the account operations. The dashboard key carries
    wildcard permissions; the scoped sending key documented below can only send.
    Customer responses omit internal email providers, tenant/queue routing, raw
    upstream payloads and stored service credentials. See /guides/api-responses
    for the response contract and migration guidance. Download the OpenAPI
    specification at https://wazobiamail.com/openapi.json. API-owned JSON
    response field names use camelCase, including pagination; user-defined data
    and third-party protocol payloads retain their own keys.
  contact:
    name: WazobiaMail Support
    url: https://wazobiamail.com/contact
servers:
  - url: https://app.wazobiamail.com/api/v1
security:
  - apiKey: []
tags:
  - name: Account
    description: >-
      Profile, password, two-factor, notifications and account data. Account
      status, plan, units and health.
  - name: Sending
    description: Sending API keys, messages, domains, SMTP access and engagement.
  - name: Mailboxes
    description: Hosted mailboxes and their credentials.
  - name: Relays
    description: Customer SMTP relay configurations.
  - name: Billing
    description: Plans, subscriptions, invoices, payments and email credits.
  - name: Plans
    description: >-
      Plan catalogue entitlements and the effective limits of the current
      account's plan.
  - name: Support
    description: Support tickets.
paths:
  /sending/spam-check:
    post:
      tags:
        - Sending
      summary: Check email spam and deliverability score
      description: >-
        Evaluate an email draft for spam indicators, deceptive links, HTML
        hygiene, and compliance before sending. This feature is restricted to
        accounts on the Business plan and above (active or trialing Business or
        Enterprise subscription, plus platform administrators). Accounts on
        Free, Starter, or Pay-as-you-go receive 403 Forbidden.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - subject
              properties:
                subject:
                  type: string
                  maxLength: 255
                  example: Your monthly account summary
                html:
                  type: string
                  example: <p>Hello! Review your account.</p>
                text:
                  type: string
                  example: Hello! Review your account.
                from:
                  type: string
                  example: Billing <billing@example.com>
                replyTo:
                  type: string
                  example: billing@example.com
                headers:
                  type: object
                  additionalProperties:
                    type: string
      responses:
        '200':
          description: >-
            Evaluation complete. Returns SpamAssassin penalty score, threshold,
            deliverabilityScore (0-100), and recommendations.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '400':
          description: Invalid payload.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: 'Forbidden: requires an active Business or Enterprise subscription.'
      security:
        - apiKey: []
components:
  schemas:
    Envelope:
      type: object
      required:
        - success
        - message
        - data
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Done
        data:
          description: Payload; shape depends on the endpoint.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Dashboard API key created at
        https://app.wazobiamail.com/dashboard/smtp-api. Send operations also
        accept a narrower sending key created through POST /sending/api-keys;
        every other operation needs the dashboard key.
      x-default: YOUR_API_KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.