List Or Create Inbox List Entry

Adds one address or domain to an inbox’s allow or block list and returns the created entry.

POST https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}

List Or Create Inbox List Entry

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entry": "<string>"
}
'

200

{
  "created_at": "2023-11-07T05:31:56Z",
  "direction": "send",
  "entry": "<string>",
  "entry_type": "email",
  "list_type": "allow",
  "organization_id": "<string>",
  "pod_id": "<string>",
  "inbox_id": "<string>",
  "read_only": true,
  "reason": "<string>"
}

Adds one address or domain to an inbox’s allow or block list and returns the created entry. This changes which mail the inbox will accept or send from that point on, so it is a standing rule rather than a one-off action. Writes to the shared AgentMail workspace: Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, and what you write here is visible and editable by the next caller. Remove one with delete_agentmail_inbox_list_entry.

Example

REST

curl -X POST "https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

• Method and path: POST /apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}
• Availability: disabled

This endpoint is disabled and cannot be called. Its historical request, schema and pricing declarations are retained for reference.

• Request URL template: https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}
• direction: path; required
• inbox_id: path; required
• type: path; required
• Runtime facts: b99ca4149ff3daae12d76cfc531f5283e79e7d7a4e0325efb1f93efd8385607e

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_agentmail_inbox_list_entry",
  "method": "POST",
  "path": "/apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "in": "path",
      "name": "direction",
      "required": true,
      "schema": {
        "description": "Direction of list entry.",
        "enum": [
          "send",
          "receive",
          "reply"
        ],
        "title": "Direction",
        "type": "string"
      }
    },
    {
      "in": "path",
      "name": "inbox_id",
      "required": true,
      "schema": {
        "description": "The ID of the inbox.",
        "title": "InboxId",
        "type": "string"
      }
    },
    {
      "in": "path",
      "name": "type",
      "required": true,
      "schema": {
        "description": "Type of list entry.",
        "enum": [
          "allow",
          "block"
        ],
        "title": "ListType",
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "entry": {
              "description": "Email address or domain to add.",
              "type": "string"
            },
            "reason": {
              "description": "Reason for adding the entry.",
              "type": "string"
            }
          },
          "required": [
            "entry"
          ],
          "title": "CreateListEntryRequest",
          "type": "object"
        }
      }
    }
  },
  "x-aisa-status": "disabled",
  "x-aisa-pricing": {
    "cost_contract": "explicit_zero",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.012,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.012
• Cost contract: explicit_zero
• Settlement evidence source: request_snapshot

Currently disabled.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

direction · enum<string> · required

Direction of list entry.

Available options: send, receive, reply

inbox_id · string · required

The ID of the inbox.

type · enum<string> · required

Type of list entry.

Available options: allow, block

Body

application/json

entry · string · required

Email address or domain to add.

reason · string

Reason for adding the entry.

Response

200

application/json

Response with status 200

created_at · string<date-time> · required

Time at which entry was created.

direction · enum<string> · required

Direction of list entry.

Available options: send, receive, reply

entry · string · required

Email address or domain of list entry.

entry_type · enum<string> · required

Whether the entry is an email address or domain.

Available options: email, domain

list_type · enum<string> · required

Type of list entry.

Available options: allow, block

organization_id · string · required

ID of organization.

pod_id · string · required

ID of pod.

inbox_id · string

ID of inbox, if entry is inbox-scoped.

read_only · boolean

Whether the entry is read-only and cannot be deleted via the API.

reason · string

Reason for adding the entry.