{"uid":"cap_BmLfSKekvP3TqUqhhuFjL","slug":"agentmail-type-dba7bcfa","name":"AgentMail Create List Entry","description":"Create List Entry","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"CreateListEntryRequest","required":["entry"],"properties":{"entry":{"type":"string","description":"Email address or domain to add."},"reason":{"type":"string","description":"Reason for adding the entry."}}},"responseSchema":{"type":"object","title":"PodListEntry","required":["entry","organization_id","direction","list_type","entry_type","created_at","pod_id"],"properties":{"entry":{"type":"string","description":"Email address or domain of list entry."},"pod_id":{"type":"string","description":"ID of pod."},"reason":{"type":"string","description":"Reason for adding the entry."},"inbox_id":{"type":"string","description":"ID of inbox, if entry is inbox-scoped."},"direction":{"enum":["send","receive","reply"],"type":"string","title":"Direction","description":"Direction of list entry."},"list_type":{"enum":["allow","block"],"type":"string","title":"ListType","description":"Type of list entry."},"created_at":{"type":"string","format":"date-time","description":"Time at which entry was created."},"entry_type":{"enum":["email","domain"],"type":"string","title":"EntryType","description":"Whether the entry is an email address or domain."},"organization_id":{"type":"string","title":"OrganizationId","description":"ID of organization."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Adds an email address or domain to an allow or block list (send, receive, or reply direction) scoped to a specific inbox","exampleAgentPrompt":"Add spam@example.com to the receive block list for inbox inbox_abc123 on AgentMail — reason is 'known spam domain'.","exampleUseCases":null,"resultDescription":"Returns a PodListEntry object containing the entry (email or domain), direction (send/receive/reply), list_type (allow/block), entry_type (email/domain), created_at timestamp, pod_id, organization_id, and optionally inbox_id and reason.","failureModes":["400 Bad Request if entry field is missing or malformed","401 Unauthorized if Bearer token is missing or invalid","404 Not Found if inbox_id does not exist","409 Conflict if the entry already exists on the list","422 Unprocessable Entity if direction or type path params are invalid enum values"],"whenToPreferThis":"Use this endpoint when you need to programmatically manage allow/block lists for a specific AgentMail inbox — for example, to prevent an AI agent from receiving or sending emails to certain addresses or domains, or to whitelist trusted contacts. Prefer this over manual inbox configuration when building automated filtering workflows for AI agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:39:50.611Z","isFirstParty":false,"canonicalSlug":"agentmail-type-dba7bcfa"}