Passer au contenu principal
GET
/
conversations
/
conversations
/
2026-09-beta
/
threads
/
{threadId}
Obtenir un seul fil de discussion
curl --request GET \
  --url https://api.hubapi.com/conversations/conversations/2026-09-beta/threads/{threadId} \
  --header 'Authorization: Bearer <token>'
{
  "archived": true,
  "associatedContactId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "inboxId": "<string>",
  "originalChannelAccountId": "<string>",
  "originalChannelId": "<string>",
  "spam": true,
  "assignedTo": "<string>",
  "closedAt": "2023-11-07T05:31:56Z",
  "latestMessageReceivedTimestamp": "2023-11-07T05:31:56Z",
  "latestMessageSentTimestamp": "2023-11-07T05:31:56Z",
  "latestMessageTimestamp": "2023-11-07T05:31:56Z",
  "threadAssociations": {
    "associatedTicketId": "<string>"
  }
}

Supported products

Autorisations

​
Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Paramètres de chemin

​
threadId
integer<int64>
requis

L'ID unique du fil de discussion.

Paramètres de requête

​
archived
boolean

S'il faut renvoyer uniquement les résultats qui ont été archivés. La valeur par défaut est faux.

​
association
enum<string>[]

Vous pouvez préciser ici un type d'association « TICKET ». Si cette option est sélectionnée, la réponse inclura un objet d'associations de fils de discussion et l'ID du ticket associé, s'il existe. S'il n'y a aucune association à un ticket avec cette conversation, l'objet d'associations de fils de discussion ne sera pas présent dans la réponse.

Options disponibles:
TICKET
​
property
string

Une propriété spécifique à inclure dans la réponse du fil de discussion.

Réponse

successful operation

​
archived
boolean
requis

Si ce fil de discussion est archivé.

​
associatedContactId
string
requis

L'ID du contact associé dans le CRM. Si le contact pour le fil de discussion n'a pas encore été ajouté ou créé, le « associatedContactId » renvoyé sera un visitorID et ne pourra pas être utilisé pour rechercher le contact dans le CRM.

​
createdAt
string<date-time>
requis

Lorsque le fil de discussion a été créé.

​
id
string
requis

L'ID unique du fil de discussion.

​
inboxId
string
requis

L'ID de la boîte de réception conversations contenant le fil de discussion.

​
originalChannelAccountId
string
requis
​
originalChannelId
string
requis
​
spam
boolean
requis

Si le fil de discussion est marqué comme spam.

​
status
enum<string>
requis

Le statut du fil : « OUVERT » ou « FERMÉ ».

Options disponibles:
CLOSED,
OPEN
​
assignedTo
string
​
closedAt
string<date-time>

Lorsque le fil de discussion a été fermé. À définir uniquement si le fil de discussion est fermé.

​
latestMessageReceivedTimestamp
string<date-time>

L'heure à laquelle le dernier message a été envoyé dans le fil de discussion.

​
latestMessageSentTimestamp
string<date-time>

L'heure à laquelle le dernier message a été envoyé dans le fil de discussion.

​
latestMessageTimestamp
string<date-time>

L'heure à laquelle le dernier message a été envoyé ou reçu dans le fil de discussion.

​
threadAssociations
object
Dernière modification le 13 avril 2026