Publer
App · 20 actions
Draft, schedule, and publish social posts, manage the media library, and monitor post activity.
Actions
| Action | What it does |
|---|---|
| Create media folder | Create a folder in the media library. |
| Create text draft | Save a text post as a private or workspace-visible draft and get its job ID. |
| Delete media folder | Delete a media folder. |
| Delete posts | Remove the exact posts you specify from the Publer workspace. |
| Get current user | Get the name and email of the connected Publer user. |
| Get job status | Check whether a publishing, drafting, or media job is still working or finished. |
| Get media item | Read one media item's URL and metadata. |
| Get post | Read a post, its attachments, and its publishing state. |
| Get social account | Read the profile and network for a connected social account. |
| Get workspace | Get a workspace's name, members, and plan. |
| List analytics charts | List the available types of analytics charts. |
| List labels | Read the labels used to organize posts and media. |
| List media | Search the workspace's media library. |
| List media folders | List root media folders or folders inside a selected parent. |
| List posts | Find posts by state, text, social account, date range, or type. |
| List social accounts | List the connected social accounts in a workspace. |
| List workspaces | List the Publer workspaces you can use. |
| Publish text post | Send the same text to selected accounts right away and get its job ID. |
| Reschedule post | Change when an existing post will publish. |
| Schedule text post | Schedule the same text on selected accounts and get its job ID. |
Create media folder
Create a folder in the media library.
Inputs
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Name
nametextRequired - Enter the folder name.
- Parent folder ID
parent_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Account IDS
account_idslistRequired - Choose the social accounts to include.
- Text
texttextRequired - Enter the text to post.
- Visibility
visibilitytext - 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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Folder ID
folder_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Post IDS
post_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Job ID
job_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Media ID
media_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Post ID
post_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Account
account_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
- Workspace
workspace_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
- Workspace
workspace_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
Outputs
dataobject- The response from Publer.
Example output
{
"data": {
"data": [
{}
]
}
}List media
Search the workspace's media library.
Inputs
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Page
pagenumber - Enter the zero-based page number.At least 0.
- Types
typeslist - Choose which media types to include.One or more of:
photo,video,gif. - Search
searchtext - 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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Parent folder ID
parent_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- States
stateslist - 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 IDS
account_idslist - Choose the social accounts to include.
- Start date
start_datedate - Choose the first date to include.
- End date
end_datedate - Choose the last date to include.
- Page
pagenumber - Enter the zero-based page number.At least 0.
- Query
querytext - Enter words in the post text.
- Post type
post_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
- Workspace
workspace_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Account IDS
account_idslistRequired - Choose the social accounts to include.
- Text
texttextRequired - 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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Post ID
post_idtextRequired - Enter the post ID from List posts.
- Scheduled at
scheduled_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
- Workspace
workspace_idtextRequired - Choose the Publer workspace.
- Account IDS
account_idslistRequired - Choose the social accounts to include.
- Text
texttextRequired - Enter the text to post.
- Scheduled at
scheduled_atdate and timeRequired - Choose when the post should publish.
Outputs
dataobject- The response from Publer.
Example output
{
"data": {
"job_id": "example"
}
}