{"uid":"cap_RtyTaQrCLw77Iz24Z1u38","slug":"agentmail-type-fd04be6c","name":"AgentMail Create List Entry","description":"Create List Entry","url":"https://mpp.api.agentmail.to/v0/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":"ListEntry","required":["entry","organization_id","direction","list_type","entry_type","created_at"],"properties":{"entry":{"type":"string","description":"Email address or domain of list entry."},"reason":{"type":"string","description":"Reason for adding the entry."},"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 an allow or block list for a specific email direction (send, receive, or reply)","exampleAgentPrompt":"Add the domain 'spam.example.com' to my AgentMail block list for incoming emails — they keep sending junk and I want to stop receiving anything from them.","exampleUseCases":null,"resultDescription":"Returns a ListEntry object confirming the newly created entry, including the email or domain added, the direction (send/receive/reply), the list type (allow/block), whether it is an email or domain entry, the organization ID, and the creation timestamp.","failureModes":["Invalid email address or domain format returns a 400 validation error","Missing required 'entry' field returns a 400 bad request","Invalid direction or type path parameter returns a 404 or 400 error","Unauthorized or missing Bearer token returns a 401 error","Duplicate entry may return a 409 conflict error"],"whenToPreferThis":"Use this endpoint when you need to programmatically manage allow or block lists for an AgentMail inbox — specifically when controlling which email addresses or domains are permitted or blocked for sending, receiving, or replying. Prefer this over manual inbox configuration when automating email access control for AI agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:31:51.044Z","isFirstParty":false,"canonicalSlug":"agentmail-type-dba7bcfa"}