Threads

The Thread resource allows you to:

  • Collect a user’s conversation threads via GET

Viewing Threads

To collect a thread for a user you make a GET request to the Thread resource:

https://api.sendhub.com/v1/threads/THREADID/?username=USERNAME&api_key=APIKEY

Where THREADID (and the full path) is obtained from the ‘resource_uri’ value in the Inbox response.

If your request is valid, you’ll get a 200 Ok status and a data response similar to this:

{
   "meta": {
      "limit": 10,
      "next": null,
      "offset": 0,
      "previous": null,
      "total_count": 3
   },
   "objects": [
      {
         "contacts": [
            {
               "id": 1111,
               "name": "John Doe"
            }
         ],
         "groups": null,
         "id": "23",
         "resource_uri": "/api/v1/messages/23/",
         "scheduled_at": null,
         "sent": "2012-02-17T20:19:16.192747",
         "text": "Inbound message test",
         "type": "message-in"
         "unread": false
      },
      {
         "contacts": [
            {
               "id": 1111,
               "name": "John Doe"
            }
         ],
         "groups": null,
         "id": "24",
         "resource_uri": "/api/v1/messages/24/",
         "scheduled_at": null,
         "sent": "2012-02-17T20:29:22.978898",
         "text": "Outbound test message",
         "type": "message-out"
         "unread": null
      },
      {
         "contacts": [
            {
               "id": 1111,
               "name": "John Doe"
            }
         ],
         "groups": null,
         "id": "25",
         "resource_uri": "/api/v1/messages/25/",
         "scheduled_at": null,
         "sent": "2012-02-17T20:36:36.639968",
         "text": "Testing",
         "type": "message-out"
         "unread": null
      }
   ]
}

Available Fields:

All fields in the Profile resource are read only.

Name Explanation
limit The number of messages displayed on a page.
next The path to the next page of the thread, if available.
offset The starting message for the current page.
previous The path to the previous page of the thread, if available.
objects The list of messages in this thread.