Get thread

curl --request GET \
  --url https://inboxapp.com/api/v2/threads/{threadId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://inboxapp.com/api/v2/threads/{threadId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://inboxapp.com/api/v2/threads/{threadId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://inboxapp.com/api/v2/threads/{threadId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://inboxapp.com/api/v2/threads/{threadId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "platform": "twitter",
  "platformId": "<string>",
  "accountLinkId": "<string>",
  "profileId": "<string>",
  "contactId": "<string>",
  "assigneeId": "<string>",
  "isRequest": true,
  "acceptanceState": "required",
  "archived": true,
  "unread": true,
  "restrictions": [
    "message:send"
  ],
  "syncing": true,
  "typingIndicators": "enabled",
  "lastMessage": {
    "id": "<string>",
    "direction": "inbound",
    "createdAt": "2026-09-14T10:32:00.000Z"
  },
  "activity": {
    "preview": "<string>",
    "direction": "inbound",
    "at": "2026-09-14T10:32:00.000Z"
  },
  "createdAt": "2026-09-14T10:32:00.000Z",
  "accountLink": {
    "id": "<string>",
    "platform": "twitter",
    "platformId": "<string>",
    "username": "jane",
    "displayName": "<string>",
    "avatarUrl": "<string>",
    "status": "active",
    "pauseReasons": [
      "billing"
    ],
    "capabilities": [
      "message:send"
    ],
    "syncedAt": "2026-09-14T10:32:00.000Z",
    "createdAt": "2026-09-14T10:32:00.000Z"
  },
  "profile": {
    "id": "<string>",
    "platform": "twitter",
    "platformId": "<string>",
    "username": "jane",
    "handle": "@jane",
    "displayName": "<string>",
    "avatarUrl": "<string>",
    "bio": "<string>",
    "location": "<string>",
    "websiteUrl": "<string>",
    "websiteDomain": "<string>",
    "verified": true,
    "isOrganization": true,
    "isProtected": true,
    "followerCount": 123,
    "followingCount": 123,
    "postCount": 123,
    "engagementCount": 123,
    "listedCount": 123,
    "accountStatus": "active",
    "platformCreatedAt": "2026-09-14T10:32:00.000Z",
    "profileUrl": "<string>",
    "updatedAt": "2026-09-14T10:32:00.000Z",
    "platformData": {
      "_tag": "twitter",
      "badge": "blue",
      "profileType": "personal",
      "professionalCategory": "<string>",
      "urlEntities": [
        {
          "url": "<string>",
          "expandedUrl": "<string>",
          "displayUrl": "<string>",
          "indices": [
            123,
            123
          ]
        }
      ],
      "bannerUrl": "<string>",
      "rawData": {}
    }
  },
  "contact": {
    "id": "<string>",
    "profiles": [
      {
        "id": "<string>",
        "platform": "twitter",
        "platformId": "<string>",
        "username": "jane",
        "handle": "@jane",
        "displayName": "<string>",
        "avatarUrl": "<string>",
        "bio": "<string>",
        "location": "<string>",
        "websiteUrl": "<string>",
        "websiteDomain": "<string>",
        "verified": true,
        "isOrganization": true,
        "isProtected": true,
        "followerCount": 123,
        "followingCount": 123,
        "postCount": 123,
        "engagementCount": 123,
        "listedCount": 123,
        "accountStatus": "active",
        "platformCreatedAt": "2026-09-14T10:32:00.000Z",
        "profileUrl": "<string>",
        "updatedAt": "2026-09-14T10:32:00.000Z",
        "platformData": {
          "_tag": "twitter",
          "badge": "blue",
          "profileType": "personal",
          "professionalCategory": "<string>",
          "urlEntities": [
            {
              "url": "<string>",
              "expandedUrl": "<string>",
              "displayUrl": "<string>",
              "indices": [
                123,
                123
              ]
            }
          ],
          "bannerUrl": "<string>",
          "rawData": {}
        }
      }
    ],
    "statusId": "<string>",
    "tagIds": [
      "<string>"
    ],
    "notes": "<string>",
    "valuation": 123,
    "assigneeId": "<string>",
    "createdAt": "2026-09-14T10:32:00.000Z",
    "updatedAt": "2026-09-14T10:32:00.000Z",
    "status": {
      "id": "<string>",
      "name": "<string>",
      "color": "#3b82f6",
      "createdAt": "2026-09-14T10:32:00.000Z"
    },
    "tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "color": "#3b82f6"
      }
    ],
    "assignee": {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>",
      "imageUrl": "<string>",
      "role": "owner",
      "createdAt": "2026-09-14T10:32:00.000Z"
    }
  },
  "assignee": {
    "id": "<string>",
    "name": "<string>",
    "email": "<string>",
    "imageUrl": "<string>",
    "role": "owner",
    "createdAt": "2026-09-14T10:32:00.000Z"
  }
}

{
  "code": "invalidRequest",
  "message": "<string>",
  "details": {
    "issues": [
      {
        "path": [
          "<string>"
        ],
        "message": "<string>"
      }
    ]
  },
  "requestId": "<string>"
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": null,
  "requestId": "<string>"
}

{
  "code": "platformNotAvailable",
  "message": "<string>",
  "details": {
    "platform": "twitter"
  },
  "requestId": "<string>"
}

{
  "code": "threadNotFound",
  "message": "<string>",
  "details": null,
  "requestId": "<string>"
}

{
  "code": "rateLimited",
  "message": "<string>",
  "details": {
    "window": "minute",
    "limit": 123,
    "resetAt": "2026-09-14T10:32:00.000Z"
  },
  "requestId": "<string>"
}

{
  "code": "internal",
  "message": "<string>",
  "details": null,
  "requestId": "<string>"
}

GET

threads

{threadId}

Get thread

curl --request GET \
  --url https://inboxapp.com/api/v2/threads/{threadId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://inboxapp.com/api/v2/threads/{threadId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://inboxapp.com/api/v2/threads/{threadId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://inboxapp.com/api/v2/threads/{threadId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://inboxapp.com/api/v2/threads/{threadId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "platform": "twitter",
  "platformId": "<string>",
  "accountLinkId": "<string>",
  "profileId": "<string>",
  "contactId": "<string>",
  "assigneeId": "<string>",
  "isRequest": true,
  "acceptanceState": "required",
  "archived": true,
  "unread": true,
  "restrictions": [
    "message:send"
  ],
  "syncing": true,
  "typingIndicators": "enabled",
  "lastMessage": {
    "id": "<string>",
    "direction": "inbound",
    "createdAt": "2026-09-14T10:32:00.000Z"
  },
  "activity": {
    "preview": "<string>",
    "direction": "inbound",
    "at": "2026-09-14T10:32:00.000Z"
  },
  "createdAt": "2026-09-14T10:32:00.000Z",
  "accountLink": {
    "id": "<string>",
    "platform": "twitter",
    "platformId": "<string>",
    "username": "jane",
    "displayName": "<string>",
    "avatarUrl": "<string>",
    "status": "active",
    "pauseReasons": [
      "billing"
    ],
    "capabilities": [
      "message:send"
    ],
    "syncedAt": "2026-09-14T10:32:00.000Z",
    "createdAt": "2026-09-14T10:32:00.000Z"
  },
  "profile": {
    "id": "<string>",
    "platform": "twitter",
    "platformId": "<string>",
    "username": "jane",
    "handle": "@jane",
    "displayName": "<string>",
    "avatarUrl": "<string>",
    "bio": "<string>",
    "location": "<string>",
    "websiteUrl": "<string>",
    "websiteDomain": "<string>",
    "verified": true,
    "isOrganization": true,
    "isProtected": true,
    "followerCount": 123,
    "followingCount": 123,
    "postCount": 123,
    "engagementCount": 123,
    "listedCount": 123,
    "accountStatus": "active",
    "platformCreatedAt": "2026-09-14T10:32:00.000Z",
    "profileUrl": "<string>",
    "updatedAt": "2026-09-14T10:32:00.000Z",
    "platformData": {
      "_tag": "twitter",
      "badge": "blue",
      "profileType": "personal",
      "professionalCategory": "<string>",
      "urlEntities": [
        {
          "url": "<string>",
          "expandedUrl": "<string>",
          "displayUrl": "<string>",
          "indices": [
            123,
            123
          ]
        }
      ],
      "bannerUrl": "<string>",
      "rawData": {}
    }
  },
  "contact": {
    "id": "<string>",
    "profiles": [
      {
        "id": "<string>",
        "platform": "twitter",
        "platformId": "<string>",
        "username": "jane",
        "handle": "@jane",
        "displayName": "<string>",
        "avatarUrl": "<string>",
        "bio": "<string>",
        "location": "<string>",
        "websiteUrl": "<string>",
        "websiteDomain": "<string>",
        "verified": true,
        "isOrganization": true,
        "isProtected": true,
        "followerCount": 123,
        "followingCount": 123,
        "postCount": 123,
        "engagementCount": 123,
        "listedCount": 123,
        "accountStatus": "active",
        "platformCreatedAt": "2026-09-14T10:32:00.000Z",
        "profileUrl": "<string>",
        "updatedAt": "2026-09-14T10:32:00.000Z",
        "platformData": {
          "_tag": "twitter",
          "badge": "blue",
          "profileType": "personal",
          "professionalCategory": "<string>",
          "urlEntities": [
            {
              "url": "<string>",
              "expandedUrl": "<string>",
              "displayUrl": "<string>",
              "indices": [
                123,
                123
              ]
            }
          ],
          "bannerUrl": "<string>",
          "rawData": {}
        }
      }
    ],
    "statusId": "<string>",
    "tagIds": [
      "<string>"
    ],
    "notes": "<string>",
    "valuation": 123,
    "assigneeId": "<string>",
    "createdAt": "2026-09-14T10:32:00.000Z",
    "updatedAt": "2026-09-14T10:32:00.000Z",
    "status": {
      "id": "<string>",
      "name": "<string>",
      "color": "#3b82f6",
      "createdAt": "2026-09-14T10:32:00.000Z"
    },
    "tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "color": "#3b82f6"
      }
    ],
    "assignee": {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>",
      "imageUrl": "<string>",
      "role": "owner",
      "createdAt": "2026-09-14T10:32:00.000Z"
    }
  },
  "assignee": {
    "id": "<string>",
    "name": "<string>",
    "email": "<string>",
    "imageUrl": "<string>",
    "role": "owner",
    "createdAt": "2026-09-14T10:32:00.000Z"
  }
}

{
  "code": "invalidRequest",
  "message": "<string>",
  "details": {
    "issues": [
      {
        "path": [
          "<string>"
        ],
        "message": "<string>"
      }
    ]
  },
  "requestId": "<string>"
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": null,
  "requestId": "<string>"
}

{
  "code": "platformNotAvailable",
  "message": "<string>",
  "details": {
    "platform": "twitter"
  },
  "requestId": "<string>"
}

{
  "code": "threadNotFound",
  "message": "<string>",
  "details": null,
  "requestId": "<string>"
}

{
  "code": "rateLimited",
  "message": "<string>",
  "details": {
    "window": "minute",
    "limit": 123,
    "resetAt": "2026-09-14T10:32:00.000Z"
  },
  "requestId": "<string>"
}

{
  "code": "internal",
  "message": "<string>",
  "details": null,
  "requestId": "<string>"
}

Path Parameters

threadId

string

required

Pattern: ^[0-9a-z]+$

Query Parameters

expand

enum<string>[]

Related resources to embed next to their ID field, one path per key, at most 4.

Maximum array length: 4

Available options:

profile,

contact,

accountLink,

assignee

Response

A conversation between one of the team's account links and one profile.

string

required

platform

string

required

Always the platform of the thread's account link and profile.

Example:

"twitter"

platformId

string | null

required

The conversation's ID on the platform. Null until the first message creates the conversation there.

accountLinkId

string

required

An account link: a platform account the team connected to Inboxapp, the team's side of a conversation.

profileId

string

required

A profile: one person's account on one platform. Not a contact ID.

contactId

string

required

A contact: the team's record of the person, with their status, tags, notes, valuation and default assignee.

assigneeId

string | null

required

The thread's own assignee, else its contact's default.

isRequest

boolean

required

True while the conversation is an incoming request the account hasn't replied to or accepted. Requests are in the requests folder, not inbox.

acceptanceState

enum<string>

required

Whether the platform needs the account to accept the conversation before replying normally. unknown when the platform doesn't say. Independent of isRequest.

Available options:

required,

notRequired,

unknown

archived

boolean

required

unread

boolean

required

Marked unread in Inboxapp. A thread no one has opened yet is not unread.

restrictions

enum<string>[]

required

Capabilities the platform disables in this conversation, on top of the account link's capabilities. Using one fails with threadRestricted.

Available options:

message:send,

message:edit,

message:delete:self,

message:unsend,

message:react,

message:reply,

message:forward,

media:image,

media:video,

media:gif,

media:file,

media:audio,

thread:typing:send,

thread:typing:receive,

thread:message-requests,

thread:delete:remote,

directory:typeahead,

thread:archive:observe,

thread:archive:mutate,

thread:read:observe,

thread:read:mutate,

profile:follow,

profile:unfollow

syncing

boolean

required

True while Inboxapp imports the conversation's older messages, so the message list may be incomplete.

typingIndicators

enum<string>

required

Whether Inboxapp sends typing indicators to the platform while someone composes in this thread. teamDefault follows the team's setting.

Available options:

enabled,

disabled,

teamDefault

lastMessage

object | null

required

The thread's latest message. Get it for its content.

Show child attributes

activity

object | null

required

The thread's latest activity: a message, or a reaction since. at is when it happened, which is not always the thread's position in a list: see order.

Show child attributes

createdAt

string<date-time>

required

Example:

"2026-09-14T10:32:00.000Z"

accountLink

object

A platform account the team connected to Inboxapp. Every conversation and message goes through one.

Show child attributes

profile

object

One person's account on one platform. Profile data is shared across teams; the team's own data about the person is on their contact.

Show child attributes

contact

object

The team's record of a person: their profiles, plus the team's CRM state about them.

Show child attributes

assignee

object

A person on the team, who can be assigned threads and contacts.

Show child attributes

Getting started

Fundamentals

Configuration

Webhooks

Event types

Reference

Resources

Platforms

Team

Account Links

Contacts

Threads

Messages

Tags

Statuses

Colors

Events

Get thread

Path Parameters

Query Parameters

Response