# sync_inbox: Refresh the inbox

Refresh the stored inbox from LinkedIn, or one conversation of it, in the background. This action can change or spend something, and it happens right away. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/sync_inbox
Authorization: Bearer YOUR_KEY
content-type: application/json

{}
```

## What you give it

- `conversationUrl` (optional): a conversation link or a profile link. LinkedIn conversation/thread URL, or the person's profile URL. Required when threadOnly=true to fetch just that one conversation. Where to get it: Open the person's profile on LinkedIn and copy the address from your browser. It looks like https://www.linkedin.com/in/their-name Or: Run `search_people` and use `people[].profileUrl`.
- `linkedinConnectionId` (optional): a connection id. LinkedIn account to sync from. Omit to use all active accounts for the setup. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.
- `threadOnly` (optional): true or false. When true (with conversationUrl set), fetch only that one conversation thread instead of syncing the whole inbox.

## What you get back

- `success`
- `taskId`: a task id
- `taskIds`
- `alreadyInProgress`
- `expiredConnections`

## Good to know

- One conversation: threadOnly true AND conversationUrl; the answer has taskId. Whole inbox: neither; the answer has taskIds, one per account, and no taskId.
- threadOnly true without conversationUrl runs a whole-inbox sync.
- A whole-inbox sync ignores linkedinConnectionId and refreshes every account.
- When a sync is already running the answer says alreadyInProgress and may carry no task id.

Page: https://heyreagent.com/docs/actions/sync_inbox