Publer

App · 20 actions

Draft, schedule, and publish social posts, manage the media library, and monitor post activity.

Actions

ActionWhat it does
Create media folderCreate a folder in the media library.
Create text draftSave a text post as a private or workspace-visible draft and get its job ID.
Delete media folderDelete a media folder.
Delete postsRemove the exact posts you specify from the Publer workspace.
Get current userGet the name and email of the connected Publer user.
Get job statusCheck whether a publishing, drafting, or media job is still working or finished.
Get media itemRead one media item's URL and metadata.
Get postRead a post, its attachments, and its publishing state.
Get social accountRead the profile and network for a connected social account.
Get workspaceGet a workspace's name, members, and plan.
List analytics chartsList the available types of analytics charts.
List labelsRead the labels used to organize posts and media.
List mediaSearch the workspace's media library.
List media foldersList root media folders or folders inside a selected parent.
List postsFind posts by state, text, social account, date range, or type.
List social accountsList the connected social accounts in a workspace.
List workspacesList the Publer workspaces you can use.
Publish text postSend the same text to selected accounts right away and get its job ID.
Reschedule postChange when an existing post will publish.
Schedule text postSchedule the same text on selected accounts and get its job ID.

Create media folder

Create a folder in the media library.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
NamenametextRequired
Enter the folder name.
Parent folder IDparent_folder_idtext
Enter a parent folder ID to nest it.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "id": "example",
    "name": "example"
  }
}

Create text draft

Save a text post as a private or workspace-visible draft and get its job ID.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Account IDSaccount_idslistRequired
Choose the social accounts to include.
TexttexttextRequired
Enter the text to post.
Visibilityvisibilitytext
Choose who can see the draft.One of: draft_private (Draft private), draft_public (Draft public). Default: draft_private.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "job_id": "example"
  }
}

Delete media folder

Delete a media folder. Choose an empty folder when testing.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Folder IDfolder_idtextRequired
Enter the media folder ID.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {}
}

Delete posts

Remove the exact posts you specify from the Publer workspace.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Post IDSpost_idslistRequired
Enter the post IDs to delete.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "deleted_ids": [
      "example"
    ]
  }
}

Get current user

Get the name and email of the connected Publer user.

Inputs

None.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "email": "example",
    "id": "example",
    "name": "example"
  }
}

Get job status

Check whether a publishing, drafting, or media job is still working or finished.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Job IDjob_idtextRequired
Enter the ID from the step that started the job.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "data": {},
    "payload": {},
    "status": "example"
  }
}

Get media item

Read one media item's URL and metadata.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Media IDmedia_idtextRequired
Enter an ID from List media.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "id": "example",
    "name": "example",
    "path": "example",
    "type": "example"
  }
}

Get post

Read a post, its attachments, and its publishing state.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Post IDpost_idtextRequired
Enter the post ID from List posts.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "account_id": "example",
    "id": "example",
    "scheduled_at": "example",
    "state": "example",
    "text": "example",
    "type": "example"
  }
}

Get social account

Read the profile and network for a connected social account.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Accountaccount_idtextRequired
Choose a social account.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "id": "example",
    "name": "example",
    "provider": "example",
    "type": "example"
  }
}

Get workspace

Get a workspace's name, members, and plan.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "id": "example",
    "name": "example"
  }
}

List analytics charts

List the available types of analytics charts.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.

Outputs

datalist
The response from Publer.
Example output
{
  "data": [
    {
      "id": "example",
      "title": "example"
    }
  ]
}

List labels

Read the labels used to organize posts and media.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "data": [
      {}
    ]
  }
}

List media

Search the workspace's media library.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Pagepagenumber
Enter the zero-based page number.At least 0.
Typestypeslist
Choose which media types to include.One or more of: photo, video, gif.
Searchsearchtext
Search by media name or caption.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "media": [
      {
        "id": "example",
        "name": "example",
        "path": "example",
        "type": "example"
      }
    ],
    "total": 1
  }
}

List media folders

List root media folders or folders inside a selected parent.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Parent folder IDparent_folder_idtext
Enter a folder ID to list its children.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "folders": [
      {
        "id": "example",
        "name": "example"
      }
    ],
    "previous_folders": [
      {
        "id": "example",
        "name": "example"
      }
    ]
  }
}

List posts

Find posts by state, text, social account, date range, or type.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Statesstateslist
Choose which post states to include.One or more of: all, scheduled, scheduled_approved (Scheduled approved), scheduled_pending (Scheduled pending), scheduled_declined (Scheduled declined), scheduled_reauth (Scheduled reauth), scheduled_locked (Scheduled locked), published, published_posted (Published posted), published_deleted (Published deleted), and 17 more.
Account IDSaccount_idslist
Choose the social accounts to include.
Start datestart_datedate
Choose the first date to include.
End dateend_datedate
Choose the last date to include.
Pagepagenumber
Enter the zero-based page number.At least 0.
Queryquerytext
Enter words in the post text.
Post typepost_typetext
Choose a content type.One of: status, link, photo, gif, video, reel, story, short, poll, document, carousel, article.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "page": 1,
    "posts": [
      {
        "account_id": "example",
        "id": "example",
        "scheduled_at": "example",
        "state": "example",
        "text": "example",
        "type": "example"
      }
    ],
    "total": 1,
    "total_pages": 1
  }
}

List social accounts

List the connected social accounts in a workspace.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.

Outputs

datalist
The response from Publer.
Example output
{
  "data": [
    {
      "id": "example",
      "name": "example",
      "provider": "example",
      "type": "example"
    }
  ]
}

List workspaces

List the Publer workspaces you can use.

Inputs

None.

Outputs

datalist
The response from Publer.
Example output
{
  "data": [
    {
      "id": "example",
      "name": "example"
    }
  ]
}

Publish text post

Send the same text to selected accounts right away and get its job ID.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Account IDSaccount_idslistRequired
Choose the social accounts to include.
TexttexttextRequired
Enter the text to post.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "job_id": "example"
  }
}

Reschedule post

Change when an existing post will publish.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Post IDpost_idtextRequired
Enter the post ID from List posts.
Scheduled atscheduled_atdate and timeRequired
Choose when the post should publish.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "account_id": "example",
    "id": "example",
    "scheduled_at": "example",
    "state": "example",
    "text": "example",
    "type": "example"
  }
}

Schedule text post

Schedule the same text on selected accounts and get its job ID.

Inputs

Workspaceworkspace_idtextRequired
Choose the Publer workspace.
Account IDSaccount_idslistRequired
Choose the social accounts to include.
TexttexttextRequired
Enter the text to post.
Scheduled atscheduled_atdate and timeRequired
Choose when the post should publish.

Outputs

dataobject
The response from Publer.
Example output
{
  "data": {
    "job_id": "example"
  }
}

On this page