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

# Run an inbox placement test

> For each mailbox in mailbox_ids, sends ONE real email to every enabled seed (never to itself), spun from the Testing template unless subject/body are given, with a reference code on the last line. Seeds are read every 30s; anything not found after 15 minutes is missing. Test sends are not campaign sends (no send_log rows). All mailboxes in one call form one run: every test gets run_id = the first test id.

**Minimum role:** `edit` (`x-min-role`). **Destructive:** `true` (`x-destructive`).



## OpenAPI

````yaml /openapi.json post /placement/run
openapi: 3.0.3
info:
  title: Sales Sequencer API
  version: '1'
  description: >-
    Every Sales Sequencer action over HTTP. Each call runs as the API key's
    creator, with that user's role, in the key's workspace. Auth: X-API-Key
    header.
servers:
  - url: https://api.salessequencer.com/api/v1
security:
  - key: []
paths:
  /placement/run:
    post:
      tags:
        - Testing
      summary: Run an inbox placement test
      description: >-
        For each mailbox in mailbox_ids, sends ONE real email to every enabled
        seed (never to itself), spun from the Testing template unless
        subject/body are given, with a reference code on the last line. Seeds
        are read every 30s; anything not found after 15 minutes is missing. Test
        sends are not campaign sends (no send_log rows). All mailboxes in one
        call form one run: every test gets run_id = the first test id.


        **Minimum role:** `edit` (`x-min-role`). **Destructive:** `true`
        (`x-destructive`).
      operationId: placement_placement_run
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              properties:
                body:
                  description: Override body (spintax ok).
                  type: string
                mailbox_ids:
                  description: Mailbox ids to test (repeat the field, up to 20).
                  items:
                    type: string
                  type: array
                subject:
                  description: Override subject (spintax ok).
                  type: string
              required:
                - mailbox_ids
              type: object
      responses:
        '200':
          description: JSON {ok, messages, test_ids, run_id}.
components:
  securitySchemes:
    key:
      in: header
      name: X-API-Key
      type: apiKey

````

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