Manage and retrieve social media accounts connected to your Publer workspaces. Use these accounts as targets when scheduling or publishing content.

### Requirements

- **Authentication**: Bearer API token
- **Scope**: `accounts`
- **Headers**:
  - `Authorization: Bearer-API YOUR_API_KEY`
  - `Publer-Workspace-Id: YOUR_WORKSPACE_ID`

### Endpoint

#### List Accounts

Retrieve all social media accounts in a workspace.

```
GET /api/v1/accounts
```
Retrieves a list of all social media accounts available in the specified workspace.

### List Accounts

get

https://app.publer.com/api/v1/accounts

Retrieves a list of social media accounts available in the specified workspace.

#### Authorizations

- **Authorization**: string Required
  - API key authentication. Format: "Bearer-API YOUR_API_KEY"

#### Header parameters

- **Publer-Workspace-Id**: string Required
  - ID of the workspace to retrieve accounts from

### Responses

- **200**: Successful operation
  - `application/json`
  - **id**: string Optional
    - Unique identifier for the account
    - Example: `63c675b54e299e9cf2b667ea`
  - **provider**: string · enum Optional
    - The social network provider
    - Example: `bluesky`
    - Possible values: `bluesky`, `facebook`, `instagram`, `linkedin`, `twitter`, `tiktok`, `youtube`, `pinterest`, `google`, `wordpress`, `telegram`, `mastodon`, `threads`
  - **name**: string Optional
    - The display name of the social media account
    - Example: `Tech News Daily`
  - **social_id**: string Optional
    - Unique identifier for the account on the social media platform
    - Example: `at://did:plc:q6gjnaw2blty4crticxkmujt/app.bsky.feed.post/3kje3rifpm22n`
  - **picture**: string Optional
    - URL to the account's avatar/logo
    - Example: `https://publer-dev.s3.amazonaws.com/uploads/avatars/bluesky_profile.jpg`
  - **type**: string · enum Optional
    - Account type
    - Example: `profile`
    - Possible values: `page`, `profile`, `group`, `business`, `channel`, `location`, `blog`

- **401**: Unauthorized
  - `application/json`

- **403**: Permission denied or missing required scope
  - `application/json`

Example Successful Response:

```
[  
  {  
    "id": "63c675b54e299e9cf2b667ea",  
    "provider": "bluesky",  
    "name": "Tech News Daily",  
    "social_id": "at://did:plc:q6gjnaw2blty4crticxkmujt/app.bsky.feed.post/3kje3rifpm22n",  
    "picture": "https://publer-dev.s3.amazonaws.com/uploads/avatars/bluesky_profile.jpg",  
    "type": "profile"  
  }  
]
```

The list of accounts returned will include all social media accounts that you have connected to your Publer workspaces and have permission to access. These accounts can be used to schedule and publish content via the Posts API.

### Supported Providers

Publer supports these network providers and account types:

| Provider   | Description | Supported Account Types                        |
|------------|-------------|----------------------------------------------|
| `facebook` | Facebook    | `page`, `group`, `profile`                  |
| `instagram`| Instagram   | `business`                                   |
| `twitter`  | Twitter/X   | `profile`                                   |
| `linkedin` | LinkedIn    | `page`, `profile`                           |
| `pinterest` | Pinterest   | `business`, `profile`                       |
| `youtube`  | YouTube     | `channel`                                   |
| `tiktok`   | TikTok      | `profile`                                   |
| `google`   | Google Business | `location`                               |
| `wordpress`| WordPress   | `blog`                                      |
| `telegram` | Telegram    | `channel`                                   |
| `mastodon` | Mastodon    | `profile`                                   |
| `threads`  | Threads     | `profile`                                   |
| `bluesky`  | Bluesky     | `profile`                                   |

### Related Resources
- [Workspaces API](https://publer.com/docs/api-reference/workspaces) - Manage organizational units
- [Posts API](https://publer.com/docs/posting/create-posts) - Create and publish content to accounts
- [Media API](https://publer.com/docs/posting/create-posts/media-handling) - Upload media files for posting