Webhook Events

Email: new_email_conversation

Sent when an email conversation handled by Jodie closes. It includes the sender's address, the subject, every message in the thread and the details Jodie collected.

HeaderValue
Event-Typenew_email_conversation

Example payload

This is the sample payload used by Send test event.

{
  "event_type": "new_email_conversation",
  "conversation_id": "eco_sample0000000000000000",
  "counterparty_email": "[email protected]",
  "subject": "Boiler replacement quote",
  "timestamp": "2026-11-02T16:50:00+00:00",
  "start_time": "2026-11-02T16:50:00+00:00",
  "end_time": "2026-11-02T16:51:30+00:00",
  "message_count": 4,
  "close_reason": "inactivity",
  "data_collections": [
    { "key": "name", "value": "Sam Taylor" },
    { "key": "phone_number", "value": "+447700900123" },
    { "key": "message", "value": "Would like a quote to replace a boiler." },
    { "key": "internal_label", "value": "LEAD" },
    {
      "key": "transcript_summary",
      "value": "Sam asked for a quote to replace a boiler and would like a call back tomorrow morning."
    }
  ],
  "messages": [
    {
      "order": 1,
      "direction": "inbound",
      "sent_by": null,
      "subject": "Boiler replacement quote",
      "message": "Hi, could I get a quote to replace my boiler?",
      "sent_at": "2026-11-02T16:50:00+00:00"
    },
    {
      "order": 2,
      "direction": "outbound",
      "sent_by": "ai",
      "subject": "Boiler replacement quote",
      "message": "Of course! What is your name and the best number to reach you on?",
      "sent_at": "2026-11-02T16:50:30+00:00"
    },
    {
      "order": 3,
      "direction": "inbound",
      "sent_by": null,
      "subject": "Boiler replacement quote",
      "message": "Sam Taylor, 07700 900123. Tomorrow morning is best.",
      "sent_at": "2026-11-02T16:51:00+00:00"
    },
    {
      "order": 4,
      "direction": "outbound",
      "sent_by": "ai",
      "subject": "Boiler replacement quote",
      "message": "Thanks Sam, I have passed that on and the team will call you tomorrow morning.",
      "sent_at": "2026-11-02T16:51:30+00:00"
    }
  ]
}

Fields

KeyTypeDescription
event_typestringAlways "new_email_conversation".
conversation_idstringThe conversation's unique ID, prefixed with eco_.
counterparty_emailstring | nullThe email address of the person writing to you.
subjectstring | nullThe conversation's subject line.
timestampstring | nullWhen the conversation was first seen, in ISO 8601 format.
start_timestring | nullWhen the first message was sent.
end_timestring | nullWhen the last message was sent.
message_countintegerThe number of messages in the conversation.
close_reasonstring | nullA short reason the conversation was closed.
data_collectionsarrayThe details collected. Same shape as on calls. [] if none.
messagesarrayEvery message, oldest first. [] if there are none.

messages items

KeyTypeDescription
orderintegerPosition in the conversation: 1, 2, 3 and so on.
directionstring"inbound" from the sender, or "outbound" from your business.
sent_bystring | nullFor outbound messages: "ai" if Jodie wrote it, or "company" if a team member did. null for inbound messages.
subjectstring | nullThe email's subject line.
messagestringThe email's plain-text body. "" if it has none.
sent_atstring | nullWhen the email was sent, in ISO 8601 format.

Need a hand?

Our team can help you connect Jodie to your systems.

Email [email protected]