{"uid":"cap_6TlHjTqXEvLORr8AxVC7e","slug":"agentmail-type-675138c8","name":"AgentMail Create Pod List Entry","description":"Create List Entry","url":"https://mpp.api.agentmail.to/v0/pods/:pod_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.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.01/call","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 a pod's allow or block list for a specific mail direction (send, receive, or reply)","exampleAgentPrompt":"Add 'spam@example.com' to the block list for the 'receive' direction on pod 'pod_abc123' in AgentMail — reason: unwanted promotional emails.","exampleUseCases":null,"resultDescription":"Returns a PodListEntry object confirming the new list entry, including the email or domain added, the pod_id, direction (send/receive/reply), list_type (allow/block), entry_type (email/domain), organization_id, and the created_at timestamp.","failureModes":["Missing required 'entry' field returns a 400 validation error","Invalid 'direction' path parameter (not send/receive/reply) returns 422","Invalid 'type' path parameter (not allow/block) returns 422","Unknown pod_id returns 404","Missing or invalid Authorization Bearer token returns 401","Duplicate entry for same pod/direction/type/entry combination may return 409 or silently succeed"],"whenToPreferThis":"Use this endpoint when you need to programmatically control which email addresses or domains an AgentMail pod can communicate with in a given direction. Ideal for setting up automated email access policies for AI agents, enforcing allowlists or blocklists on agent inboxes, or dynamically restricting communication partners as part of an agentic workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-27T17:49:47.296Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:41:31.924Z","isFirstParty":false,"canonicalSlug":"agentmail-type-675138c8"}