# Publer

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

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/publer

## Actions

### Create media folder

Create a folder in the media library.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Name (`name`, text, required): Enter the folder name.
- Parent folder ID (`parent_folder_id`, text): Enter a parent folder ID to nest it.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- Account IDS (`account_ids`, list, required): Choose the social accounts to include.
- Text (`text`, text, required): Enter the text to post.
- Visibility (`visibility`, text): Choose who can see the draft. One of: `draft_private` (Draft private), `draft_public` (Draft public). Default: `draft_private`.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "job_id": "example"
  }
}
```

### Delete media folder

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

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Folder ID (`folder_id`, text, required): Enter the media folder ID.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {}
}
```

### Delete posts

Remove the exact posts you specify from the Publer workspace.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Post IDS (`post_ids`, list, required): Enter the post IDs to delete.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "deleted_ids": [
      "example"
    ]
  }
}
```

### Get current user

Get the name and email of the connected Publer user.

**Inputs**: None.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- Job ID (`job_id`, text, required): Enter the ID from the step that started the job.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "data": {},
    "payload": {},
    "status": "example"
  }
}
```

### Get media item

Read one media item's URL and metadata.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Media ID (`media_id`, text, required): Enter an ID from List media.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "id": "example",
    "name": "example",
    "path": "example",
    "type": "example"
  }
}
```

### Get post

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

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Post ID (`post_id`, text, required): Enter the post ID from List posts.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- Account (`account_id`, text, required): Choose a social account.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "id": "example",
    "name": "example",
    "provider": "example",
    "type": "example"
  }
}
```

### Get workspace

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

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "id": "example",
    "name": "example"
  }
}
```

### List analytics charts

List the available types of analytics charts.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.

**Outputs**

- `data` (list): The response from Publer.

**Example output**

```json
{
  "data": [
    {
      "id": "example",
      "title": "example"
    }
  ]
}
```

### List labels

Read the labels used to organize posts and media.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "data": [
      {}
    ]
  }
}
```

### List media

Search the workspace's media library.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Page (`page`, number): Enter the zero-based page number. At least 0.
- Types (`types`, list): Choose which media types to include. One or more of: `photo`, `video`, `gif`.
- Search (`search`, text): Search by media name or caption.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- Parent folder ID (`parent_folder_id`, text): Enter a folder ID to list its children.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- States (`states`, list): 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_ids`, list): Choose the social accounts to include.
- Start date (`start_date`, date): Choose the first date to include.
- End date (`end_date`, date): Choose the last date to include.
- Page (`page`, number): Enter the zero-based page number. At least 0.
- Query (`query`, text): Enter words in the post text.
- Post type (`post_type`, text): Choose a content type. One of: `status`, `link`, `photo`, `gif`, `video`, `reel`, `story`, `short`, `poll`, `document`, `carousel`, `article`.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.

**Outputs**

- `data` (list): The response from Publer.

**Example output**

```json
{
  "data": [
    {
      "id": "example",
      "name": "example",
      "provider": "example",
      "type": "example"
    }
  ]
}
```

### List workspaces

List the Publer workspaces you can use.

**Inputs**: None.

**Outputs**

- `data` (list): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- Account IDS (`account_ids`, list, required): Choose the social accounts to include.
- Text (`text`, text, required): Enter the text to post.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "job_id": "example"
  }
}
```

### Reschedule post

Change when an existing post will publish.

**Inputs**

- Workspace (`workspace_id`, text, required): Choose the Publer workspace.
- Post ID (`post_id`, text, required): Enter the post ID from List posts.
- Scheduled at (`scheduled_at`, date and time, required): Choose when the post should publish.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "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_id`, text, required): Choose the Publer workspace.
- Account IDS (`account_ids`, list, required): Choose the social accounts to include.
- Text (`text`, text, required): Enter the text to post.
- Scheduled at (`scheduled_at`, date and time, required): Choose when the post should publish.

**Outputs**

- `data` (object): The response from Publer.

**Example output**

```json
{
  "data": {
    "job_id": "example"
  }
}
```
