# Accounts

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.

```http
GET /api/v1/accounts
```

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

## List Accounts

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

```json
{"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Accounts","description":"Endpoints for managing connected social accounts"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"BearerApiAuth":[]}],"components":{"securitySchemes":{"BearerApiAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"API key authentication. Format: \"Bearer-API YOUR_API_KEY\""}},"schemas":{"Account":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the account"},"provider":{"type":"string","description":"The social network provider","enum":["bluesky","facebook","instagram","linkedin","twitter","tiktok","youtube","pinterest","google","wordpress","telegram","mastodon","threads"]},"name":{"type":"string","description":"The display name of the social media account"},"social_id":{"type":"string","description":"Unique identifier for the account on the social media platform"},"picture":{"type":"string","description":"URL to the account's avatar/logo"},"type":{"type":"string","description":"Account type","enum":["page","profile","group","business","channel","location","blog"]}}},"401ErrorResponseWithWorkspace":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}},"403ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/accounts":{"get":{"summary":"List Accounts","description":"Retrieves a list of social media accounts available in the specified workspace.","tags":["Accounts"],"parameters":[{"schema":{"type":"string"},"name":"Publer-Workspace-Id","in":"header","description":"ID of the workspace to retrieve accounts from","required":true}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Account"}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401ErrorResponseWithWorkspace"}}}},"403":{"description":"Permission denied or missing required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403ErrorResponse"}}}}}}}}}
```

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.

The accounts data provides important information about the social media profiles available for posting, including their configuration settings and current synchronization status.

### Supported Providers

Publer supports these network providers and account types:

<table data-header-hidden><thead><tr><th width="161.348388671875"></th><th width="191.26324462890625"></th><th></th></tr></thead><tbody><tr><td>Provider</td><td>Description</td><td>Supported Account Types</td></tr><tr><td><code>facebook</code></td><td>Facebook</td><td><code>page</code>, <code>group</code>, <code>profile</code></td></tr><tr><td><code>instagram</code></td><td>Instagram</td><td><code>business</code></td></tr><tr><td><code>twitter</code></td><td>Twitter/X</td><td><code>profile</code></td></tr><tr><td><code>linkedin</code></td><td>LinkedIn</td><td><code>page</code>, <code>profile</code></td></tr><tr><td><code>pinterest</code></td><td>Pinterest</td><td><code>business</code>, <code>profile</code></td></tr><tr><td><code>youtube</code></td><td>YouTube</td><td><code>channel</code></td></tr><tr><td><code>tiktok</code></td><td>TikTok</td><td><code>profile</code></td></tr><tr><td><code>google</code></td><td>Google Business</td><td><code>location</code></td></tr><tr><td><code>wordpress</code></td><td>WordPress</td><td><code>blog</code></td></tr><tr><td><code>telegram</code></td><td>Telegram</td><td><code>channel</code></td></tr><tr><td><code>mastodon</code></td><td>Mastodon</td><td><code>profile</code></td></tr><tr><td><code>threads</code></td><td>Threads</td><td><code>profile</code></td></tr><tr><td><code>bluesky</code></td><td>Bluesky</td><td><code>profile</code></td></tr></tbody></table>

### 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