Skip to main content
GET
/
inbox
/
{contactId}
Get Contact Messages
curl --request GET \
  --url https://api.lemlist.com/api/inbox/{contactId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "_id": "act_vRoP8AMFMxqfSeDjR",
      "type": "emailsSent",
      "messageId": "<CAPLqhUKnWmszLsJxMO3osKL7YgU3-b_5kC+f4SvqYOVfzRc28g@mail.gmail.com>",
      "createdAt": "2024-12-05T16:39:41.416Z",
      "teamId": "tea_b4rMsi2trB42WyuWP",
      "leadId": "lea_jcw2hneu7qs7iYKBr",
      "campaignId": "cam_JnZqKnuSvoD4jsQuo",
      "sequenceId": "seq_BMMzxq84R32u4oNvQ",
      "sequenceStep": 0,
      "sendUserId": "usr_7RCLS4LdYP2oc8jmE",
      "sendUserName": "Camille INGOUF",
      "sendUserEmail": "camille@lemtest.com",
      "sendUserMailboxId": "usm_bn6KxhSrHZEak2NM6",
      "leadEmail": "victoire@lemlist.co",
      "contactId": "ctc_wfKeM8EmiTikud7QE",
      "message": "<html><div style=\"min-width: 360px\"></div><div dir=\"ltr\">\n    <div>Hello lemlist Team! 😎<br style=\"box-sizing: border-box;\"><br style=\"box-sizing: border-box;\">I joined lemlist last Monday, and I am humbly offering you the chance to meet me (and probably my cat, Megatron 😽🤖) through a 15-minute call at your convenience! You can book it <span style=\"cursor: pointer; background: var(--tertiary2-color-100); color: var(--alert); box-sizing: border-box;\" data-error=\"true\">[here]</span>(https://app.lemcal.com/@camille-ingouf/reunion-de-15-minute?leadId=lea_jcw2hneu7qs7iYKBr).<br style=\"box-sizing: border-box;\"><br style=\"box-sizing: border-box;\">See you soon!<br style=\"box-sizing: border-box;\"><br style=\"box-sizing: border-box;\">Camille INGOUF</div>\n    <div class=\"gmail_extra\">\n      <div class=\"gmail_signature\" data-smartmail=\"gmail_signature\"><div dir=\"ltr\"><div><div dir=\"ltr\"></div></div></div></div>\n      \n    </div>\n    </div>\n<span summary=\"/api/reply/data-ll-tsk_ke6Bo8Az5E68mzhbS\"></span>\n<img alt=\"logo\" src=\"https://zr0.lemlst.org/api/track/open/usr_7RCLS4LdYP2oc8jmE/tsk_ke6Bo8Az5E68mzhbS\" height=\"1\" width=\"1\"></html>",
      "subject": "Meet me !",
      "attachments": []
    },
    {
      "_id": "act_7yfGhxmPfKbxZaWHa",
      "type": "emailsReplied",
      "messageId": "<CAKs+3EYjH0POGz0H-rS1XHH1YnG9LtN2m4y8LocddFWWMm8HBw@mail.gmail.com>",
      "createdAt": "2024-12-03T10:10:45.000Z",
      "fromEmail": "victoire@lemlist.co",
      "teamId": "tea_b4rMsi2trB42WyuWP",
      "leadId": "lea_WoeA2FAw8jemE2Mex",
      "campaignId": "cam_FYRAZMW5utAA7LXCN",
      "sequenceId": "seq_L9e465mzuwq3R63NC",
      "sequenceStep": 0,
      "sendUserId": "usr_t2KCwPen66NrrqGtQ",
      "sendUserName": "Christophe OPOIX",
      "sendUserEmail": "christophe.o@lemtest.com",
      "sendUserMailboxId": "usm_zs86Mc8ZbHXfkLBAC",
      "leadEmail": "victoire@lemlist.co",
      "contactId": "ctc_wfKeM8EmiTikud7QE",
      "message": "<div dir=\"ltr\">Haha Welcome Christophe, j&#39;adore cette campagne ! <br><br>A très vite, <div>Victoire </div></div><br><div class=\"gmail_quote gmail_quote_container\"><div dir=\"ltr\" class=\"gmail_attr\">On Tue, Dec 3, 2024 at 10:52 AM Christophe OPOIX &lt;<a href=\"mailto:christophe.o@lemtest.com\">christophe.o@lemtest.com</a>&gt; wrote:<br></div><blockquote class=\"gmail_quote\" style=\"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex\"><div style=\"min-width:360px\"></div><div dir=\"ltr\">\n    <div><p style=\"margin:0px;box-sizing:border-box\">Hey Victoire  , </p><p style=\"margin:0px;box-sizing:border-box\"><br style=\"box-sizing:border-box\"></p><p style=\"margin:0px;box-sizing:border-box\">I hope this email finds you well!</p><p style=\"margin:0px;box-sizing:border-box\"><br style=\"box-sizing:border-box\"></p><p style=\"margin:0px;box-sizing:border-box\">Have you ever heard about Christophe Opoix? <br> <br>🇫🇷 He was a member of the French Parliament during the French Revolution, <br>🏘️ He has a street named after him<br><strong style=\"font-weight:700;box-sizing:border-box\">📙 </strong>He authored the famous &quot;Beurre frais épuré, et conservant longtemps ses bonnes qualités, sans devenir rance&quot;.<br style=\"box-sizing:border-box\"><br style=\"box-sizing:border-box\"><img width=\"134\" style=\"width: 134px; display: block; vertical-align: top; margin: 5px auto; text-align: center; border-style: none; padding: 0px 1px; box-sizing: border-box;\" src=\"https://zr0.lemlst.org/api/files/Files/fil_gGjMMAcLNwc7q654u.png\"></p><p style=\"margin:0px;box-sizing:border-box\"><br style=\"box-sizing:border-box\"></p><p style=\"margin:0px;box-sizing:border-box\">Unfortunately, this brilliant man died ages ago...</p><p style=\"margin:0px;box-sizing:border-box\"><br style=\"box-sizing:border-box\"></p><p style=\"margin:0px;box-sizing:border-box\">But wait, there&#39;s another Christophe Opoix you might be interested in meeting—one who is very much alive and well! Yes, that&#39;s me. I&#39;ve just joined Lemlist, and I&#39;m looking forward to meeting everyone for a quick chat.</p><p style=\"margin:0px;box-sizing:border-box\"><br style=\"box-sizing:border-box\"></p><p style=\"margin:0px;box-sizing:border-box\">☑️ Book an appointment on 📅 <a style=\"color:rgb(51,138,241);text-decoration:none;background-color:transparent;box-sizing:border-box;font-weight:500\" href=\"https://app.lemcal.com/@christophe-opoix/15-min-chat?leadId=lea_WoeA2FAw8jemE2Mex\" target=\"_blank\">my lemcal</a> !</p><p style=\"margin:0px;box-sizing:border-box\"><br></p><p style=\"margin:0px;box-sizing:border-box\">Feel free to reach out and get to know me better. I'm excited to be part of the team and eager to contribute to our collective success.</p><p style=\"margin:0px;box-sizing:border-box\">Looking forward to seeing you all soon!<br style=\"box-sizing:border-box\"><br style=\"box-sizing:border-box\">Best regards, as your contemporary, Christophe Opoix</p></div>\n    <div class=\"gmail_extra\">\n      <div class=\"gmail_signature\"><div dir=\"ltr\"><div><div dir=\"ltr\"></div></div></div></div>\n      \n    </div>\n    </div>\n<span summary=\"/api/reply/data-ll-tsk_FvpBdB4NwuyG7GGTf\"></span>\n<img alt=\"logo\" src=\"https://zr0.lemlst.org/api/track/open/usr_t2KCwPen66NrrqGtQ/tsk_FvpBdB4NwuyG7GGTf\" height=\"1\" width=\"1\">\n</blockquote></div>\n",
      "subject": "Re: Have you heard about Christophe Opoix ?",
      "attachments": []
    },
    {
      "_id": "act_mjdoySn9mkfbcMS5e",
      "type": "emailsSent",
      "messageId": "<CADuPnhJfe0BDrR47w4DNsvQT9kStS3DHQ9B4cP2=8AciE_M42w@mail.gmail.com>",
      "createdAt": "2024-12-03T09:52:55.319Z",
      "teamId": "tea_b4rMsi2trB42WyuWP",
      "leadId": "lea_WoeA2FAw8jemE2Mex",
      "campaignId": "cam_FYRAZMW5utAA7LXCN",
      "sequenceId": "seq_L9e465mzuwq3R63NC",
      "sequenceStep": 0,
      "sendUserId": "usr_t2KCwPen66NrrqGtQ",
      "sendUserName": "Christophe OPOIX",
      "sendUserEmail": "christophe.o@lemtest.com",
      "sendUserMailboxId": "usm_zs86Mc8ZbHXfkLBAC",
      "leadEmail": "victoire@lemlist.co",
      "contactId": "ctc_wfKeM8EmiTikud7QE",
      "message": "<html><div style=\"min-width: 360px\"></div><div dir=\"ltr\">\n    <div><p style=\"margin: 0px; box-sizing: border-box;\">Hey Victoire  ,&nbsp;</p><p style=\"margin: 0px; box-sizing: border-box;\"><br style=\"box-sizing: border-box;\"></p><p style=\"margin: 0px; box-sizing: border-box;\">I hope this email finds you well!</p><p style=\"margin: 0px; box-sizing: border-box;\"><br style=\"box-sizing: border-box;\"></p><p style=\"margin: 0px; box-sizing: border-box;\">Have you ever heard about Christophe Opoix? <br> <br>🇫🇷 He was a member of the French Parliament during the French Revolution, <br>🏘️ He has a street named after him<br><strong style=\"font-weight: 700; box-sizing: border-box;\">📙&nbsp;</strong>He authored the famous \"Beurre frais épuré, et conservant longtemps ses bonnes qualités, sans devenir rance\".<br style=\"box-sizing: border-box;\"><br style=\"box-sizing: border-box;\"><img  width=\"134\" style=\"width: 134px; display: block; vertical-align: top; margin: 5px auto; text-align: center; border-style: none; cursor: pointer; padding: 0px 1px; box-sizing: border-box;\" src=\"https://zr0.lemlst.org/api/files/Files/fil_gGjMMAcLNwc7q654u.png\"></p><p style=\"margin: 0px; box-sizing: border-box;\"><br style=\"box-sizing: border-box;\"></p><p style=\"margin: 0px; box-sizing: border-box;\">Unfortunately, this brilliant man died ages ago...</p><p style=\"margin: 0px; box-sizing: border-box;\"><br style=\"box-sizing: border-box;\"></p><p style=\"margin: 0px; box-sizing: border-box;\">But wait, there's another Christophe Opoix you might be interested in meeting—one who is very much alive and well! Yes, that's me. I've just joined Lemlist, and I'm looking forward to meeting everyone for a quick chat.</p><p style=\"margin: 0px; box-sizing: border-box;\"><br style=\"box-sizing: border-box;\"></p><p style=\"margin: 0px; box-sizing: border-box;\">☑️ Book an appointment on 📅 <a style=\"color: rgb(51, 138, 241); text-decoration: none; background-color: transparent; user-select: auto; box-sizing: border-box; font-weight: 500;\" href=\"https://app.lemcal.com/@christophe-opoix/15-min-chat?leadId=lea_WoeA2FAw8jemE2Mex\">my lemcal</a> !</p><p style=\"margin: 0px; box-sizing: border-box;\"><br></p><p style=\"margin: 0px; box-sizing: border-box;\">Feel free to reach out and get to know me better. I'm excited to be part of the team and eager to contribute to our collective success.</p><p style=\"margin: 0px; box-sizing: border-box;\">Looking forward to seeing you all soon!<br style=\"box-sizing: border-box;\"><br style=\"box-sizing: border-box;\">Best regards, as your contemporary, Christophe Opoix</p></div>\n    <div class=\"gmail_extra\">\n      <div class=\"gmail_signature\" data-smartmail=\"gmail_signature\"><div dir=\"ltr\"><div><div dir=\"ltr\"></div></div></div></div>\n      \n    </div>\n    </div>\n<span summary=\"/api/reply/data-ll-tsk_FvpBdB4NwuyG7GGTf\"></span>\n<img alt=\"logo\" src=\"https://zr0.lemlst.org/api/track/open/usr_t2KCwPen66NrrqGtQ/tsk_FvpBdB4NwuyG7GGTf\" height=\"1\" width=\"1\"></html>",
      "subject": "Have you heard about Christophe Opoix  ?",
      "attachments": []
    }
  ],
  "pagination": {
    "totalItems": 3,
    "currentPage": 1,
    "nextPage": null,
    "previousPage": null,
    "perPage": 10,
    "totalPages": 1
  }
}
This endpoint uses the Inbox/Contact Message object.
This endpoint retrieves all messages for a specific contact.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
contactId
string
required

The unique identifier of the contact

Query Parameters

​
userId
string

ID of the user viewing the conversation

​
limit
integer

The maximum number of records to return

​
skip
integer

Number of items to skip. Default: 0

​
markAsRead
boolean

When true, marks the conversation as read. Default: false

Response

Success

​
data
object[]
​
pagination
object