AgentMail

AgentMail é uma plataforma de e-mail baseada em API construída para agentes e automação. O AgentMail permite que você crie caixas de e-mail sob demanda, envie e receba mensagens, responda a threads, gerencie rascunhos e organize conversas com rótulos — tudo por meio de uma API REST simples projetada para acesso programático.

Por que AgentMail?

  • E-mail Nativo para Agentes: Projetado para agentes de IA e automação — crie caixas de e-mail, envie mensagens e gerencie threads sem sobrecarga da interface do usuário voltada para o usuário.
  • Ciclo de Vida Completo do E-mail: Envie novas mensagens, responda a threads, encaminhe e-mails, gerencie rascunhos e agende envios — tudo a partir de uma única API.
  • Gerenciamento de Threads e Conversas: Organize e-mails em threads com suporte completo de leitura, resposta, encaminhamento e rótulo para rastreamento de conversas estruturadas.
  • Fluxo de Trabalho de Rascunho: Componha rascunhos, atualize-os, agende envios e envie quando estiver pronto — perfeito para fluxos de trabalho de revisão antes de enviar.
  • Organização por Rótulos: Marque threads e mensagens com rótulos personalizados para filtrar, rotear e automatizar downstream.

Usando AgentMail no Zoen

A integração AgentMail do Zoen conecta seus fluxos de trabalho de agentes diretamente ao AgentMail usando uma chave de API. Com 20 operações que abrangem caixas de e-mail, threads, mensagens e rascunhos, você pode construir automações de e-mail poderosas sem escrever código de backend.

Benefícios-chave de usar AgentMail no Zoen:

  • Criação dinâmica de caixa de e-mail: Lance novas caixas de e-mail sob demanda para cada agente, fluxo de trabalho ou cliente — perfeito para o tratamento de e-mail multi-inquilino.
  • Processamento automatizado de e-mail: Liste e leia mensagens de entrada e, em seguida, acione ações downstream com base no conteúdo, remetente ou rótulos.
  • E-mail conversacional: Responda a threads e encaminhe mensagens para manter as conversas fluindo naturalmente em seus fluxos de trabalho automatizados.
  • Fluxos de trabalho de rascunho e revisão: Crie rascunhos, atualize-os com conteúdo gerado por IA e envie quando aprovado — ideal para padrões de humano-na-loop.
  • Organização de e-mail: Aplique rótulos a threads e mensagens para categorizar, filtrar e rotear e-mails por meio de seu pipeline de automação.

Usage Instructions

Integrate AgentMail into your workflow. Create and manage email inboxes, send and receive messages, reply to threads, manage drafts, and organize threads with labels. Requires API Key.

Actions

agentmail_create_draft

Create a new email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to create the draft in
tostringNoRecipient email addresses (comma-separated)
subjectstringNoDraft subject line
textstringNoPlain text draft body
htmlstringNoHTML draft body
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)
inReplyTostringNoID of message being replied to
sendAtstringNoISO 8601 timestamp to schedule sending

Output

ParameterTypeDescription
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
textstringPlain text content
htmlstringHTML content
previewstringDraft preview text
labelsarrayLabels assigned to the draft
inReplyTostringMessage ID this draft replies to
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_create_inbox

Create a new email inbox with AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
usernamestringNoUsername for the inbox email address
domainstringNoDomain for the inbox email address
displayNamestringNoDisplay name for the inbox

Output

ParameterTypeDescription
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_delete_draft

Delete an email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the draft
draftIdstringYesID of the draft to delete

Output

ParameterTypeDescription
deletedbooleanWhether the draft was successfully deleted

agentmail_delete_inbox

Delete an email inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to delete

Output

ParameterTypeDescription
deletedbooleanWhether the inbox was successfully deleted

agentmail_delete_thread

Delete an email thread in AgentMail (moves to trash, or permanently deletes if already in trash)

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the thread
threadIdstringYesID of the thread to delete
permanentbooleanNoForce permanent deletion instead of moving to trash

Output

ParameterTypeDescription
deletedbooleanWhether the thread was successfully deleted

agentmail_forward_message

Forward an email message to new recipients in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the message
messageIdstringYesID of the message to forward
tostringYesRecipient email addresses (comma-separated)
subjectstringNoOverride subject line
textstringNoAdditional plain text to prepend
htmlstringNoAdditional HTML to prepend
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)

Output

ParameterTypeDescription
messageIdstringID of the forwarded message
threadIdstringID of the thread

agentmail_get_draft

Get details of a specific email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox the draft belongs to
draftIdstringYesID of the draft to retrieve

Output

ParameterTypeDescription
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
textstringPlain text content
htmlstringHTML content
previewstringDraft preview text
labelsarrayLabels assigned to the draft
inReplyTostringMessage ID this draft replies to
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_get_inbox

Get details of a specific email inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to retrieve

Output

ParameterTypeDescription
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_get_message

Get details of a specific email message in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the message
messageIdstringYesID of the message to retrieve

Output

ParameterTypeDescription
messageIdstringUnique identifier for the message
threadIdstringID of the thread this message belongs to
fromstringSender email address
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
subjectstringMessage subject
textstringPlain text content
htmlstringHTML content
labelsarrayLabels assigned to the message
timestampstringTime the message was sent or drafted
createdAtstringCreation timestamp

agentmail_get_thread

Get details of a specific email thread including messages in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the thread
threadIdstringYesID of the thread to retrieve

Output

ParameterTypeDescription
threadIdstringUnique identifier for the thread
subjectstringThread subject
sendersarrayList of sender email addresses
recipientsarrayList of recipient email addresses
messageCountnumberNumber of messages in the thread
labelsarrayLabels assigned to the thread
lastMessageAtstringTimestamp of last message
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
messagesarrayMessages in the thread
messageIdstringUnique identifier for the message
fromstringSender email address
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
subjectstringMessage subject
textstringPlain text content
htmlstringHTML content
labelsarrayLabels assigned to the message
timestampstringTime the message was sent or drafted
createdAtstringCreation timestamp

agentmail_list_drafts

List email drafts in an inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to list drafts from
limitnumberNoMaximum number of drafts to return
pageTokenstringNoPagination token for next page of results

Output

ParameterTypeDescription
draftsarrayList of drafts
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
previewstringDraft preview text
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
countnumberTotal number of drafts
nextPageTokenstringToken for retrieving the next page

agentmail_list_inboxes

List all email inboxes in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
limitnumberNoMaximum number of inboxes to return
pageTokenstringNoPagination token for next page of results

Output

ParameterTypeDescription
inboxesarrayList of inboxes
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
countnumberTotal number of inboxes
nextPageTokenstringToken for retrieving the next page

agentmail_list_messages

List messages in an inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to list messages from
limitnumberNoMaximum number of messages to return
pageTokenstringNoPagination token for next page of results

Output

ParameterTypeDescription
messagesarrayList of messages in the inbox
messageIdstringUnique identifier for the message
fromstringSender email address
toarrayRecipient email addresses
subjectstringMessage subject
previewstringMessage preview text
timestampstringTime the message was sent or drafted
createdAtstringCreation timestamp
countnumberTotal number of messages
nextPageTokenstringToken for retrieving the next page

agentmail_list_threads

List email threads in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to list threads from
limitnumberNoMaximum number of threads to return
pageTokenstringNoPagination token for next page of results
labelsstringNoComma-separated labels to filter threads by
beforestringNoFilter threads before this ISO 8601 timestamp
afterstringNoFilter threads after this ISO 8601 timestamp

Output

ParameterTypeDescription
threadsarrayList of email threads
threadIdstringUnique identifier for the thread
subjectstringThread subject
sendersarrayList of sender email addresses
recipientsarrayList of recipient email addresses
messageCountnumberNumber of messages in the thread
lastMessageAtstringTimestamp of last message
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
countnumberTotal number of threads
nextPageTokenstringToken for retrieving the next page

agentmail_reply_message

Reply to an existing email message in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to reply from
messageIdstringYesID of the message to reply to
textstringNoPlain text reply body
htmlstringNoHTML reply body
tostringNoOverride recipient email addresses (comma-separated)
ccstringNoCC email addresses (comma-separated)
bccstringNoBCC email addresses (comma-separated)
replyAllbooleanNoReply to all recipients of the original message

Output

ParameterTypeDescription
messageIdstringID of the sent reply message
threadIdstringID of the thread

agentmail_send_draft

Send an existing email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the draft
draftIdstringYesID of the draft to send

Output

ParameterTypeDescription
messageIdstringID of the sent message
threadIdstringID of the thread

agentmail_send_message

Send an email message from an AgentMail inbox

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to send from
tostringYesRecipient email address (comma-separated for multiple)
subjectstringYesEmail subject line
textstringNoPlain text email body
htmlstringNoHTML email body
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)

Output

ParameterTypeDescription
threadIdstringID of the created thread
messageIdstringID of the sent message
subjectstringEmail subject line
tostringRecipient email address

agentmail_update_draft

Update an existing email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the draft
draftIdstringYesID of the draft to update
tostringNoRecipient email addresses (comma-separated)
subjectstringNoDraft subject line
textstringNoPlain text draft body
htmlstringNoHTML draft body
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)
sendAtstringNoISO 8601 timestamp to schedule sending

Output

ParameterTypeDescription
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
textstringPlain text content
htmlstringHTML content
previewstringDraft preview text
labelsarrayLabels assigned to the draft
inReplyTostringMessage ID this draft replies to
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_update_inbox

Update the display name of an email inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to update
displayNamestringYesNew display name for the inbox

Output

ParameterTypeDescription
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_update_message

Add or remove labels on an email message in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the message
messageIdstringYesID of the message to update
addLabelsstringNoComma-separated labels to add to the message
removeLabelsstringNoComma-separated labels to remove from the message

Output

ParameterTypeDescription
messageIdstringUnique identifier for the message
labelsarrayCurrent labels on the message

agentmail_update_thread

Add or remove labels on an email thread in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the thread
threadIdstringYesID of the thread to update
addLabelsstringNoComma-separated labels to add to the thread
removeLabelsstringNoComma-separated labels to remove from the thread

Output

ParameterTypeDescription
threadIdstringUnique identifier for the thread
labelsarrayCurrent labels on the thread

On this page