All pages
Powered by GitBook
1 of 1

Loading...

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.

GET /api/v1/accounts

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

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:

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 - Manage organizational units

  • Posts API - Create and publish content to accounts

  • Media API - Upload media files for posting

List Accounts

get

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

Authorizations
Header parameters
Publer-Workspace-IdanyRequired

ID of the workspace to retrieve accounts from

Responses
200
Successful operation
application/json
401
Unauthorized
application/json
403
Permission denied or missing required scope
application/json
get
GET /api/v1/accounts HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "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"
  }
]