> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postsyncer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account

> Retrieve one connected social media account, including Pinterest boards

## Get Account

Retrieves one connected social media account from a workspace the authenticated user has access to. Requires the `accounts:read` permission.

For **Pinterest** accounts the response also includes `boards`. Pass a board `id` as `accounts[].settings.board_id` when you [create](https://docs.postsyncer.com/api-reference/posts/create.md#pinterest-boards) or [update](https://docs.postsyncer.com/api-reference/posts/update.md) a post.

### Request

**id** `integer` *required*

The account ID, from [List Accounts](https://docs.postsyncer.com/api-reference/accounts/list.md)

```bash theme={null}
curl -X GET "https://postsyncer.com/api/v1/accounts/245" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

### Response

**id** `integer`

Account ID

**workspace\_id** `integer`

Workspace the account belongs to

**platform** `string`

Social network, for example `pinterest`, `instagram` or `twitter`

**username** `string`

Handle on the platform

**name** `string`

Display name

**avatar** `string`

Avatar URL

**has\_expired** `boolean`

`true` when the account must be reconnected in PostSyncer

**is\_default** `boolean`

Whether the account is selected by default for new posts

**boards** `object[]`

Pinterest boards, each with `id`, `name` and `image_cover_url`. Empty for other platforms.

```json theme={null}
{
  "id": 245,
  "workspace_id": 12,
  "platform": "pinterest",
  "username": "postsyncer",
  "name": "PostSyncer",
  "avatar": "https://i.pinimg.com/avatar.jpg",
  "has_expired": false,
  "is_default": true,
  "support_threads": false,
  "is_verified": false,
  "boards": [
    {
      "id": "549755885175",
      "name": "Recipes",
      "image_cover_url": "https://i.pinimg.com/cover.jpg"
    }
  ]
}
```

### Error Codes

**401** `Unauthorized`

Missing or invalid API token

**403** `Forbidden`

Token does not have the `accounts:read` permission

**404** `Not Found`

No account with this ID in a workspace you can access


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.