Account links

Overview

Account links represent X (Twitter) accounts connected to your Inbox team. Each account link enables you to send and receive DMs through that account.

List account links

Retrieve all connected accounts:

const { data: accountLinks } = await client.get("/account-links");

console.log(`${accountLinks.length} connected account(s)`);

accountLinks.forEach((account) => {
  console.log(`@${account.username} (${account.id})`);
});

curl https://inboxapp.com/api/v1/account-links \
  -H "Authorization: Bearer $INBOX_API_TOKEN"

Response:

[
  {
    "id": "df6jbw4h36qm5d9iu2sgn7kx",
    "platform": "twitter",
    "platformId": "1566123362161725440",
    "name": "Acme Corp",
    "username": "acmecorp",
    "image": "https://pbs.twimg.com/profile_images/.../photo.jpg",
    "createdAt": "2024-06-01T12:00:00.000Z",
    "status": "active",
    "syncedAt": "2025-01-15T10:30:00.000Z"
  },
  {
    "id": "g7ht2kw9xr5m8fp3yjnbqvce",
    "platform": "twitter",
    "platformId": "1876543210987654321",
    "name": "Acme Support",
    "username": "acmesupport",
    "image": "https://pbs.twimg.com/profile_images/.../photo.jpg",
    "createdAt": "2024-08-01T09:00:00.000Z",
    "status": "active",
    "syncedAt": "2025-01-14T08:00:00.000Z"
  }
]

GET /account-links returns a flat array, not a wrapped object. The same applies to GET /members, GET /tags, and GET /statuses.

Key fields

Field	Description
`id`	Inbox account link ID — use this for all API operations
`platform`	Always `"twitter"` for now
`platformId`	The X numeric user ID
`username`	X handle without `@`
`image`	Profile picture URL
`status`	`"active"`, `"offline"` (X signed out your account), or `"paused"` (team scheduled for deletion or other rare circumstances)
`syncedAt`	When this account completed its first full sync. `null` if sync hasn’t finished yet

Using account links

Send messages from specific accounts

Specify which account to send from using accountLinkId:

const { data: accountLinks } = await client.get("/account-links");
const salesAccount = accountLinks.find((a: any) => a.username === "acmecorp");

await client.post("/threads/messages", {
  externalPlatformId: "1876543210987654321",
  accountLinkId: salesAccount.id,
  content: "Hi! Reaching out from our sales team.",
});

Filter threads by account

View conversations for specific accounts using accountLinkIds:

const { data } = await client.get("/threads", {
  params: {
    "accountLinkIds[0]": "df6jbw4h36qm5d9iu2sgn7kx",
  },
});

console.log(`${data.threads.length} threads for this account`);

Lookup threads by account

Check if a thread exists for a specific account–prospect pair:

const { data: thread } = await client.get("/threads/lookup", {
  params: {
    externalPlatformId: "1876543210987654321",
    accountLinkId: "df6jbw4h36qm5d9iu2sgn7kx",
  },
});

if (thread) {
  console.log("Thread exists:", thread.id);
} else {
  console.log("No existing thread");
}

Multi-account patterns

Account selection logic

Choose the appropriate account based on context:

interface AccountSelector {
  accountLinkId: string;
  condition: (prospect: any) => boolean;
}

const accountRules: AccountSelector[] = [
  {
    accountLinkId: "df6jbw4h36qm5d9iu2sgn7kx",
    condition: (prospect) => prospect.followerCount >= 100000,
  },
  {
    accountLinkId: "g7ht2kw9xr5m8fp3yjnbqvce",
    condition: () => true,
  },
];

function selectAccount(prospect: any): string {
  for (const rule of accountRules) {
    if (rule.condition(prospect)) return rule.accountLinkId;
  }
  return accountRules[accountRules.length - 1].accountLinkId;
}

Cross-account thread check

Check if you have any existing thread with a prospect across all accounts:

async function findAnyThread(prospectPlatformId: string) {
  const { data: accountLinks } = await client.get("/account-links");

  for (const account of accountLinks) {
    const { data: thread } = await client.get("/threads/lookup", {
      params: {
        externalPlatformId: prospectPlatformId,
        accountLinkId: account.id,
      },
    });

    if (thread) {
      return { thread, accountLink: account };
    }
  }

  return null;
}

const existing = await findAnyThread("1876543210987654321");
if (existing) {
  console.log(`Found thread via @${existing.accountLink.username}`);
}

ID types

Account links have two ID types. Use the correct one:

Property	Example	Use for
`id` (Inbox ID)	`"df6jbw4h36qm5d9iu2sgn7kx"`	All API operations
`platformId` (X ID)	`"1566123362161725440"`	Reference only

// Correct: Use Inbox ID
await client.get("/threads", {
  params: { "accountLinkIds[0]": account.id },
});

// Wrong: Using platform ID
await client.get("/threads", {
  params: { "accountLinkIds[0]": account.platformId },
});

Connecting new accounts

Account links are connected through the Inbox dashboard, not the API. To add a new X account:

Go to inboxapp.com
Navigate to Settings → Accounts
Make sure you have the Chrome extension installed
Click Open X and select the account to link

The new account will then appear in API responses.

List account links

GET /account-links

List threads

Filter by accountLinkIds

Lookup thread

Find thread by account + prospect

Quick send

Send from specific account

Next steps

Team setup

Configure team members

Managing threads

Work with conversations

Working with messages

Send and receive messages

Quick start

Send your first message

Getting started

Fundamentals

Configuration

Overview

List account links

Key fields

Using account links

Send messages from specific accounts

Filter threads by account

Lookup threads by account

Multi-account patterns

Account selection logic

Cross-account thread check

ID types

Connecting new accounts

List account links

List threads

Lookup thread

Quick send

Next steps

Team setup

Managing threads

Working with messages

Quick start

​Overview

​List account links

​Key fields

​Using account links

​Send messages from specific accounts

​Filter threads by account

​Lookup threads by account

​Multi-account patterns

​Account selection logic

​Cross-account thread check

​ID types

​Connecting new accounts

​Related endpoints

List account links

List threads

Lookup thread

Quick send

​Next steps

Team setup

Managing threads

Working with messages

Quick start

Overview

List account links

Key fields

Using account links

Send messages from specific accounts

Filter threads by account

Lookup threads by account

Multi-account patterns

Account selection logic

Cross-account thread check

ID types

Connecting new accounts

Related endpoints

Next steps