FAQ

// Correct: Inbox ID for operations
await client.get(`/threads/${thread.id}`);

// Correct: Platform ID for lookups
await client.get("/threads/lookup", {
  params: { externalPlatformId: "1876543210987654321" },
});

const { data: threads } = await client.get("/threads/lookup-by-username", {
  params: { username: "jordanrivera" },
});

curl "https://api.twitter.com/2/users/by/username/johndoe" \
  -H "Authorization: Bearer YOUR_X_BEARER_TOKEN"

await client.post("/threads/messages", {
  externalPlatformId: "1876543210987654321",
  accountLinkId: "df6jbw4h36qm5d9iu2sgn7kx",
  content: "Hello!",
});

const { data } = await client.get("/threads", {
  params: { inbox: "default" },
});

await client.patch(`/threads/${threadId}`, {
  done: true,
});

await client.delete(`/threads/${threadId}`);

const { data: accountLinks } = await client.get("/account-links");
const accountLinkIds = new Set(accountLinks.map((a) => a.id));

const { data } = await client.get(`/threads/${threadId}/messages`, {
  params: { limit: 1 },
});

const lastMessage = data.messages[0];
if (lastMessage && accountLinkIds.has(lastMessage.authorId)) {
  console.log("Last message was from our account");
} else {
  console.log("Last message was from the prospect");
}

await client.patch(`/prospects/${prospectId}/context`, {
  notes: "Interested in Enterprise plan",
  valuation: 50000,
});

await client.patch(`/prospects/${prospectId}/context`, {
  addTags: ["t8rvk2m5j0xn4wq7ybftcael", "u9swl3n6k1yo5xr8zcgudbfm"],
  statusId: "s3km7xj9wq5p2bvnhfdteoly",
});

await client.post("/threads/messages", {
  externalPlatformId: "1876543210987654321",
  accountLinkId: "df6jbw4h36qm5d9iu2sgn7kx",
  content: "Hello from sales!",
});

await client.patch(`/threads/${threadId}`, {
  assigneeId: 'r3km7xj9wq5p2bvnhfdteoly'
});

const { data } = await client.get('/threads', {
  params: {
    'filters[assignees][noAssignee]': true
  }
});

let cursorId: string | undefined;
let cursorTimestamp: string | undefined;

do {
  const { data } = await client.get("/threads", {
    params: {
      limit: 100,
      ...(cursorId && { cursorId, cursorTimestamp }),
    },
  });

  // Process data.threads
  cursorId = data.nextCursor?.id;
  cursorTimestamp = data.nextCursor?.timestamp;
} while (cursorId);

const { data } = await client.get("/threads", {
  params: {
    inbox: "default",
    "filters[tags][selectedIds][0]": "t8rvk2m5j0xn4wq7ybftcael",
    "filters[assignees][noAssignee]": true,
  },
});