For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
contact@agentmail.ccDiscord
DocumentationAPI ReferenceKnowledge BaseChangelog
DocumentationAPI ReferenceKnowledge BaseChangelog
  • API Reference
      • GETList Inboxes
      • GETGet Inbox
      • POSTCreate Inbox
      • PATCHUpdate Inbox
      • DELDelete Inbox
        • GETList Entries
        • GETGet List Entry
        • POSTCreate List Entry
        • DELDelete List Entry
LogoLogo
contact@agentmail.ccDiscord
API ReferenceInboxesLists

Create List Entry

POST
/v0/inboxes/:inbox_id/lists/:direction/:type
POST
/v0/inboxes/:inbox_id/lists/:direction/:type
1from agentmail import AgentMail
2
3client = AgentMail(
4    api_key="YOUR_TOKEN_HERE",
5)
6
7client.inboxes.lists.create(
8    inbox_id="inbox_id",
9    direction="send",
10    type="allow",
11    entry="entry",
12)
1{
2  "created_at": "2024-01-15T09:30:00Z",
3  "direction": "send",
4  "entry": "entry",
5  "entry_type": "email",
6  "list_type": "allow",
7  "organization_id": "organization_id",
8  "pod_id": "pod_id",
9  "inbox_id": "inbox_id",
10  "read_only": true,
11  "reason": "reason"
12}
**CLI:** ```bash agentmail inboxes:lists create --inbox-id <inbox_id> --direction <direction> --type <type> --entry user@example.com ```
Was this page helpful?
Previous

Delete List Entry

Next
Built with

CLI:

$agentmail inboxes:lists create --inbox-id <inbox_id> --direction <direction> --type <type> --entry user@example.com

Authentication

AuthorizationBearer

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

Path parameters

inbox_idstringRequired
The ID of the inbox.
directionenumRequired
Direction of list entry.
Allowed values:
typeenumRequired
Type of list entry.
Allowed values:

Request

This endpoint expects an object.
entrystringRequired
Email address or domain to add.
reasonstringOptional
Reason for adding the entry.

Response

This endpoint returns an object.
created_atdatetime
Time at which entry was created.
directionenum
Direction of list entry.
Allowed values:
entrystring
Email address or domain of list entry.
entry_typeenum
Whether the entry is an email address or domain.
Allowed values:
list_typeenum
Type of list entry.
Allowed values:
organization_idstring
ID of organization.
pod_idstring
ID of pod.
inbox_idstring

ID of inbox, if entry is inbox-scoped.

read_onlyboolean

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

reasonstring
Reason for adding the entry.

Errors

400
Validation Error