# Emplifi

> Read your Emplifi social analytics, posts, Community messages, Care cases, Listening mentions and Facebook ads, label Community messages, manage asset collections, and start workflows on new posts, messages and mentions.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/emplifi

## Actions

### Add labels to Community messages

Label Community messages or posts. A label that doesn't exist yet is created as a global label. Needs permission to apply global labels.

**Inputs**

- Message IDs (`content_ids`, list, required): The Community messages or posts, each as its network, a dash and its id, such as facebook-849715935050458_1520511894637588. Build it from a Community message's platform and id.
- Labels (`labels`, list, required): The label names. A label that doesn't exist yet is created as a global label.

**Outputs**

- `count` (number): How many came back
- `labels` (list): The labels
- `results` (list): What happened to each message

**Example output**

```json
{
  "count": 1,
  "labels": [
    "Needs reply"
  ],
  "results": [
    {
      "content_id": "facebook-849715935050458_1520511894637588",
      "status": "ok"
    }
  ]
}
```

### Archive collection

Archive a collection. It can be restored at any time, and must be archived before it can be deleted.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id.

**Outputs**

- `collection_id` (text): The collection's id
- `status` (text): ok when Emplifi made the change

**Example output**

```json
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}
```

### Create collection

Create an asset collection, private to you or shared with everyone in the account. An account holds 500 collections at most.

**Inputs**

- Name (`name`, text, required): The collection's name.
- Description (`description`, text): What the collection is for.
- Who can use it (`permission`, text): Private or global. Defaults to private. One of: `private` (Private (only you)), `global` (Global (everyone in the account)).

**Outputs**

- `collection_id` (text): The new collection's id
- `name` (text): The collection's name
- `permission` (text): private or global

**Example output**

```json
{
  "collection_id": "O1yxunQBZejoR1EGQshy",
  "name": "Winter campaign",
  "permission": "private"
}
```

### Delete collection

Delete an archived collection and every asset in it. This can't be undone.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id.

**Outputs**

- `collection_id` (text): The collection's id
- `status` (text): ok when Emplifi made the change

**Example output**

```json
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}
```

### Get aggregated post metrics

Get one metric, such as engagements or number of posts, totalled over the posts several profiles on any network published in a period.

**Inputs**

- Profiles (`profiles`, list, required): The profiles to include, up to 100.
- Metric (`metric`, text, required): The metric. Each covers only some networks; those marked insights need insights connected. One of: `engagement_rate` (Engagement rate), `insights_avg_time_watched` (Avg time watched (insights)), `insights_completion_rate` (Completion rate (insights)), `insights_engagements` (Engagements (insights)), `insights_impressions` (Impressions (insights)), `insights_impressions_engagement_rate` (Impressions engagement rate (insights)), `insights_initial_video_views` (Initial video views (insights)), `insights_link_clicks` (Link clicks (insights)), `insights_media_view_time` (Media view time (insights)), `insights_media_views` (Media views (insights)), and 36 more.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Split by (`split_by`, list): Up to two ways to break the number down. Leave empty for one total. One or more of: `date.day` (Day), `date.week` (Week), `date.month` (Month), `date.quarter` (Quarter), `date.year` (Year), `platform` (Network), `profile`, `post_labels` (Content label), `profile_label` (Profile label), `content_type` (Content type), `media_type` (Media type).
- Content labels (`content_label_ids`, list): Only content carrying any of these labels.

**Outputs**

- `count` (number): How many came back
- `rows` (list): One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name

**Example output**

```json
{
  "count": 1,
  "rows": [
    {
      "page_posts": 3,
      "profile": {
        "id": "564919357",
        "platform": "twitter"
      }
    }
  ]
}
```

### Get Community metrics

Get a Community metric, such as the number of messages or the median response time, for some profiles over a period.

**Inputs**

- Profiles (`profiles`, list, required): The profiles to include.
- Metric (`metric`, text, required): The metric. One of: `content_count` (Number of messages and posts), `message_count` (Messages in conversations), `response_time` (Median response time), `response_time_business_hours` (Median response time in business hours), `salesforce_lead_count` (Salesforce leads escalated), `salesforce_case_count` (Salesforce cases escalated).
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Split by (`split_by`, list): How to break the number down. Response times split by period use when the answer was sent. One or more of: `date.day` (Day), `date.week` (Week), `date.month` (Month), `profile`, `community_type` (Message type), `sentiment`, `resolve_status` (Resolved or not), `post_label` (Content label), `profile_label` (Profile label).
- Content labels (`content_label_ids`, list): Only content carrying any of these labels.

**Outputs**

- `count` (number): How many came back
- `rows` (list): One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name

**Example output**

```json
{
  "count": 1,
  "rows": [
    {
      "content_count": 42,
      "date": "2026-11-10"
    }
  ]
}
```

### Get Facebook ads metrics

Get Facebook ads metrics, such as spend, impressions and clicks, for some ad accounts over a period. Money is in US dollars.

**Inputs**

- Ad accounts (`ad_account_ids`, list, required): The Facebook ad accounts to read. Pick them, or give their ids.
- Metrics (`metrics`, list, required): The metrics. One or more of: `impressions`, `spend` (Amount spent (USD)), `clicks`, `cpc` (Cost per click), `ctr` (Click-through rate), `cpm` (Cost per 1,000 impressions), `engagement_rate` (Engagement rate), `post_engagement` (Post engagement), `page_engagement` (Page engagement), `page_likes` (Page likes), and 19 more.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Split by (`split_by`, list): Up to two ways to break the numbers down. By day covers 31 days at most. One or more of: `date.day` (Day), `date.week` (Week), `date.month` (Month), `ad_account` (Ad account), `campaign`, `objective`, `publisher_platform` (Publishing platform), `placement`, `country`, `age`, `gender`.

**Outputs**

- `count` (number): How many came back
- `rows` (list): One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name

**Example output**

```json
{
  "count": 1,
  "rows": [
    {
      "clicks": 71,
      "date": "2026-11-10",
      "spend": 125.4
    }
  ]
}
```

### Get Listening metrics

Get Listening metrics, such as mentions, authors and interactions, for your queries over a period.

**Inputs**

- Listening queries (`listening_query_ids`, list, required): The Listening queries to read. Pick them, or give their ids.
- Metrics (`metrics`, list, required): The metrics. One or more of: `authors`, `comments`, `content_count` (Content count), `interactions`, `potential_impressions` (Potential impressions), `shares`.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Split by (`split_by`, list): Up to two ways to break the numbers down. Leave empty for totals. One or more of: `listening_query` (Listening query), `platform` (Network or source), `content_type` (Content type), `sentiment`, `country`, `language`, `media_type` (Media type), `hashtag`, `keyword`, `topic`, `post_label` (Content label).
- Sentiment (`sentiments`, list): Only mentions with any of these sentiments. One or more of: `positive`, `neutral`, `negative`.
- Sources (`platforms`, list): Only mentions from these networks or sources. One or more of: `facebook`, `instagram`, `twitter` (X (Twitter)), `youtube`, `blogs`, `forums`, `news`.

**Outputs**

- `count` (number): How many came back
- `rows` (list): One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name

**Example output**

```json
{
  "count": 1,
  "rows": [
    {
      "content_count": 21,
      "platform": "twitter"
    }
  ]
}
```

### Get profile metrics

Get daily metrics such as followers, reach and views for one network's profiles over a period, one row per day, week or month.

**Inputs**

- Network (`network`, text, required): The network the profiles are on. One of: `facebook`, `instagram`, `twitter` (X (Twitter)), `youtube`, `linkedin`, `pinterest`, `tiktok`.
- Profiles (`profile_ids`, list, required): The network's profiles to read, up to 100. Pick them, or give their ids.
- Metrics (`metrics`, list, required): Up to 25 metrics. Those marked insights need the profile's insights connected in Emplifi. One or more of: `fans_change` (Fans change), `fans_lifetime` (Fans lifetime), `insights_fan_adds` (Fan adds (insights)), `insights_fan_adds_unique` (Fan adds unique (insights)), `insights_fans_lifetime` (Fans lifetime (insights)), `insights_follows` (Follows (insights)), `insights_media_views` (Media views (insights)), `insights_net_follows` (Net follows (insights)), `insights_post_impressions` (Post impressions (insights)), `insights_reach` (Reach (insights)), and 41 more.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Split by (`split_by`, list): How to break the numbers down. Defaults to by day. One or more of: `date.day` (Day), `date.week` (Week), `date.month` (Month), `profile`, `profile_label` (Profile label).

**Outputs**

- `count` (number): How many came back
- `rows` (list): One row per bucket: the dimensions it was split by (date, profile, platform and so on) and each metric's value under the metric's name

**Example output**

```json
{
  "count": 2,
  "rows": [
    {
      "date": "2026-11-01",
      "fans_lifetime": 209119
    },
    {
      "date": "2026-11-02",
      "fans_lifetime": 209171
    }
  ]
}
```

### List ad accounts

List the Facebook ad accounts your Emplifi user can see that were active in a period.

**Inputs**

- From (`date_start`, date): The first day. Leave empty for 90 days ago.
- Until (`date_end`, date): The last day. Leave empty for today.

**Outputs**

- `ad_accounts` (list): The ad accounts
- `count` (number): How many came back

**Example output**

```json
{
  "ad_accounts": [
    {
      "id": "640875043123456",
      "name": "Emplifi ads"
    }
  ],
  "count": 1
}
```

### List Care case messages

List a Care case's messages, newest first, 50 at a time (24 months are kept), and its internal notes if you want them.

**Inputs**

- Case ID (`case_id`, text, required): The case's id, from 'List Care cases' or a trigger.
- Include internal notes (`include_internal_notes`, true/false): Turn on to include your team's internal notes.
- Fields (`fields`, list): What to get for each message. Leave empty for everything. One or more of: `attachments`, `author`, `care_case` (Care case), `content_type` (Content type), `conversation_id` (Conversation ID), `created_by` (Created by), `created_time` (Created time), `id`, `languages`, `message`, and 10 more.
- Next page (`after`, text): The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

**Outputs**

- `count` (number): How many came back
- `messages` (list): The messages
- `next` (text): The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
- `remaining` (number): How many more there are after this page

**Example output**

```json
{
  "count": 1,
  "messages": [
    {
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "created_time": "2026-11-10T20:30:57+02:00",
      "id": "facebook-1234567890",
      "message": "Hello, my order hasn't arrived",
      "message_type": "comment",
      "origin": "User-Generated Content",
      "platform": "facebook",
      "url": "https://www.facebook.com/1234567890"
    }
  ],
  "next": "eyJuZXh0IjoiZXlK",
  "remaining": 12
}
```

### List Care cases

List the Care cases created in a period, with their status, priority and who they are assigned to. Gets one page; run it again with the next page cursor to see more.

**Inputs**

- From (`date_start`, date and time): The start. Leave empty for 7 days ago.
- Until (`date_end`, date and time): The end. Leave empty for now.
- Profiles (`profiles`, list): Only cases for these profiles.
- Case IDs (`case_ids`, list): Only these cases, by id.
- Fields (`fields`, list): What to get for each case. Leave empty for everything. One or more of: `assigned_users` (Assigned users), `author`, `case_number` (Case number), `closed_time` (Closed time), `created_time` (Created time), `custom_fields` (Custom fields), `done_time` (Done time), `first_assigned_users` (First assigned users), `id`, `languages`, and 6 more.
- Order (`sort_order`, text): Which come first. Defaults to newest or highest first. One of: `desc` (Newest or highest first), `asc` (Oldest or lowest first).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.
- Next page (`after`, text): The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

**Outputs**

- `cases` (list): The cases
- `count` (number): How many came back
- `next` (text): The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
- `remaining` (number): How many more there are after this page

**Example output**

```json
{
  "cases": [
    {
      "assigned_users": [
        {
          "email": "ana@example.com",
          "id": "d123456",
          "name": "Ana Lopez"
        }
      ],
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "case_number": 3879,
      "created_time": "2026-11-10T08:52:25.248Z",
      "id": "CCC_123456_8GWYLU3OSK2d7rxwHg_3879",
      "platform": "facebook",
      "priority": "high",
      "profile_id": "164929129743",
      "sentiment": "neutral",
      "status": "open"
    }
  ],
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "remaining": 12
}
```

### List collection assets

List the images and videos in a collection, with download links that work for an hour, or get one asset.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id.
- Asset ID (`asset_id`, text): Only this asset. Leave empty for every asset.

**Outputs**

- `assets` (list): The assets
- `count` (number): How many came back

**Example output**

```json
{
  "assets": [
    {
      "collectionId": "g11N6XQBZejoR1EGGGq8",
      "createdTime": "2026-10-03T13:48:31.206Z",
      "description": "Hero image",
      "expirationDate": "2026-12-31T23:59:59.000Z",
      "id": "NOo5u3QBrFWnaVYeCNdn",
      "note": "Approved by legal",
      "type": "image",
      "updatedTime": "2026-10-03T13:48:31.206Z",
      "url": "https://cdn-assets-sign.socialbakers.com/asset.jpg"
    }
  ],
  "count": 1
}
```

### List collections

List up to 500 asset collections, active and archived.

**Inputs**: None.

**Outputs**

- `collections` (list): The collections
- `count` (number): How many came back

**Example output**

```json
{
  "collections": [
    {
      "createdBy": {
        "email": "ana@example.com",
        "userId": "1336595"
      },
      "createdTime": "2026-10-02T12:32:57.849Z",
      "id": "g11N6XQBZejoR1EGGGq8",
      "name": "Winter campaign",
      "permission": "private",
      "status": "active",
      "updatedTime": "2026-10-02T12:32:58.603Z"
    }
  ],
  "count": 1
}
```

### List Community messages

List the comments, direct messages, mentions, posts and reviews in Emplifi Community for some profiles (the last 90 days are kept). Gets one page; run it again with the next page cursor to see more.

**Inputs**

- Profiles (`profiles`, list, required): The profiles whose messages to list.
- From (`date_start`, date and time): The start. Leave empty for 7 days ago.
- Until (`date_end`, date and time): The end. Leave empty for now.
- Message types (`community_types`, list): Only these kinds of message. One or more of: `comment`, `direct_message` (Direct message), `post`, `wall_post` (Wall post), `review`, `ad_comment` (Comment on an ad), `mention_comment` (Mention in a comment), `mention_post_and_media_tag` (Mention or tag in a post), `mention_story_mention` (Mention in a story).
- Content types (`content_types`, list): Only these content types. One or more of: `comment`, `conversation`, `post`, `shared` (Share), `story`.
- From (`origin`, text): Only messages from your audience, or only your brand's own. One of: `User-Generated Content` (From your audience), `Brand's Content` (From your brand).
- Content labels (`content_label_ids`, list): Only content carrying any of these labels.
- Fields (`fields`, list): What to get for each message. Leave empty for everything. One or more of: `author`, `care_case` (Care case), `community_type` (Community type), `content_type` (Content type), `created_time` (Created time), `id`, `message`, `messages`, `origin`, `parent_post` (Parent post), and 6 more.
- Order (`sort_order`, text): Which come first. Defaults to newest or highest first. One of: `desc` (Newest or highest first), `asc` (Oldest or lowest first).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.
- Next page (`after`, text): The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

**Outputs**

- `count` (number): How many came back
- `next` (text): The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
- `posts` (list): The messages
- `remaining` (number): How many more there are after this page

**Example output**

```json
{
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "posts": [
    {
      "author": {
        "id": "17841400000000000",
        "name": "Jo Bloggs",
        "url": "https://www.instagram.com/jobloggs"
      },
      "community_type": "comment",
      "content_type": "comment",
      "created_time": "2026-11-10T16:01:57+02:00",
      "id": "17873624615551014",
      "message": "Where can I buy this?",
      "origin": "User-Generated Content",
      "platform": "instagram",
      "post_labels": [
        {
          "id": "5d879004a44a4cbcb13e",
          "name": "Campaign A"
        }
      ],
      "profileId": "17841420590000000",
      "sentiment": "neutral",
      "url": "https://www.instagram.com/p/CUKrCG1rxNi/"
    }
  ],
  "remaining": 12
}
```

### List content labels

List the content labels your Emplifi user can see, with their ids.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back
- `labels` (list): The content labels

**Example output**

```json
{
  "count": 1,
  "labels": [
    {
      "id": "5d879004a44a4cbcb13e",
      "name": "Campaign A"
    }
  ]
}
```

### List Facebook ads

List the Facebook ads of some ad accounts that were active in a period, with the fields and results you choose.

**Inputs**

- Ad accounts (`ad_account_ids`, list, required): The Facebook ad accounts to read. Pick them, or give their ids.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Fields (`fields`, list): What to get for each ad. Leave empty for everything. One or more of: `ad_account_id` (Ad account ID), `ad_account_name` (Ad account name), `ad_campaign_id` (Ad campaign ID), `ad_campaign_name` (Ad campaign name), `ad_set_id` (Ad set ID), `ad_set_name` (Ad set name), `ad_type` (Ad type), `attachments`, `clicks`, `cost_per_post_engagement` (Cost per post engagement), and 20 more.
- Sort by (`sort_by`, text): What to sort by. Leave empty for Emplifi's order. One of: `clicks`, `cost_per_post_engagement` (Cost per post engagement), `cpc`, `cpm`, `ctr`, `engagement_rate` (Engagement rate), `impressions`, `inline_link_clicks` (Inline link clicks), `interaction_count` (Interaction count), `landing_page_view` (Landing page view), and 4 more.
- Order (`sort_order`, text): Which come first. Defaults to newest or highest first. One of: `desc` (Newest or highest first), `asc` (Oldest or lowest first).
- How many (`limit`, number): How many ads to return, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `ads` (list): The ads
- `count` (number): How many came back

**Example output**

```json
{
  "ads": [
    {
      "ad_account_name": "Emplifi ads",
      "clicks": 71,
      "created_time": "2026-11-01T08:28:18.000Z",
      "id": "23851631725210369",
      "impressions": 20735,
      "name": "Winter launch",
      "objective": "OUTCOME_AWARENESS",
      "spend": 125.4,
      "status": "ACTIVE"
    }
  ],
  "count": 1
}
```

### List Listening mentions

List the posts and comments your Listening queries found in a period. Gets one page; run it again with the next page cursor to see more.

**Inputs**

- Listening queries (`listening_query_ids`, list, required): The Listening queries to read. Pick them, or give their ids.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Fields (`fields`, list): What to get for each mention. Leave empty for everything. One or more of: `attachments`, `author`, `authorId` (Author ID), `comments`, `content_type` (Content type), `country`, `created_time` (Created time), `id`, `interactions`, `language`, and 12 more.
- Sort by (`sort_by`, text): Highest first by this. Leave empty for Emplifi's order. One of: `comments`, `interactions`, `potential_impressions` (Potential impressions), `shares`.
- Sentiment (`sentiments`, list): Only mentions with any of these sentiments. One or more of: `positive`, `neutral`, `negative`.
- Sources (`platforms`, list): Only mentions from these networks or sources. One or more of: `facebook`, `instagram`, `twitter` (X (Twitter)), `youtube`, `blogs`, `forums`, `news`.
- Content labels (`content_label_ids`, list): Only content carrying any of these labels.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.
- Next page (`after`, text): The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

**Outputs**

- `count` (number): How many came back
- `next` (text): The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
- `posts` (list): The mentions
- `remaining` (number): How many more there are after this page

**Example output**

```json
{
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "posts": [
    {
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "created_time": "2026-11-04T16:06:00+00:00",
      "id": "164929129743_10155892118379744",
      "interactions": 5628,
      "listening_queries": [
        {
          "id": "LNQ_172196_6241c597857f917a0529975d"
        }
      ],
      "message": "Loving the new Emplifi dashboards",
      "platform": "facebook",
      "sentiment": "positive",
      "url": "https://www.facebook.com/164929129743/posts/10155892118379744"
    }
  ],
  "remaining": 12
}
```

### List Listening queries

List your Listening queries with their ids and whether each is running, paused or done.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back
- `queries` (list): The Listening queries

**Example output**

```json
{
  "count": 1,
  "queries": [
    {
      "community_enabled": false,
      "id": "LNQ_172196_6241c597857f917a0529975d",
      "name": "Brand mentions",
      "status": "Running"
    }
  ]
}
```

### List posts

List the posts one network's profiles published in a period, with the fields and metrics you choose. Gets one page; run it again with the next page cursor to see more.

**Inputs**

- Network (`network`, text, required): The network the profiles are on. One of: `facebook`, `instagram`, `twitter` (X (Twitter)), `youtube`, `linkedin`, `pinterest`, `tiktok`, `snapchat`.
- Profiles (`profile_ids`, list, required): The network's profiles to read, up to 100. Pick them, or give their ids.
- From (`date_start`, date): The first day. Leave empty for 7 days ago.
- Until (`date_end`, date): The last day, included. Leave empty for today.
- Fields (`fields`, list): What to get for each post. Leave empty for everything except insights metrics. One or more of: `attachments`, `author`, `authorId` (Author ID), `comments`, `comments_sentiment` (Comments sentiment), `content`, `content_type` (Content type), `created_time` (Created time), `deleted`, `grade`, and 105 more.
- Sort by (`sort_by`, text): What to sort by. Defaults to when it was published. X posts can't be sorted. One of: `comments`, `created_time` (Created time), `interactions`, `interactions_per_1k_fans` (Interactions per 1,000 fans), `reactions`, `reactions_by_type.anger` (Reactions by type: anger), `reactions_by_type.haha` (Reactions by type: haha), `reactions_by_type.like` (Reactions by type: like), `reactions_by_type.love` (Reactions by type: love), `reactions_by_type.sorry` (Reactions by type: sorry), and 48 more.
- Order (`sort_order`, text): Which come first. Defaults to newest or highest first. One of: `desc` (Newest or highest first), `asc` (Oldest or lowest first).
- Content labels (`content_label_ids`, list): Only content carrying any of these labels.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.
- Next page (`after`, text): The 'next' cursor an earlier run of this step gave, to read the next page. When it is given, the other fields are ignored.

**Outputs**

- `count` (number): How many came back
- `next` (text): The cursor for the next page: give it as 'Next page' to read on. Empty on the last page.
- `posts` (list): The posts
- `remaining` (number): How many more there are after this page

**Example output**

```json
{
  "count": 1,
  "next": "eyJuZXh0IjoiZXlK",
  "posts": [
    {
      "author": {
        "id": "164929129743",
        "name": "Emplifi",
        "url": "https://www.facebook.com/emplifi"
      },
      "content": "Join us at the summit next week",
      "created_time": "2026-11-10T16:06:00+00:00",
      "id": "164929129743_10155892118379744",
      "media_type": "link",
      "post_labels": [
        {
          "id": "5d879004a44a4cbcb13e",
          "name": "Campaign A"
        }
      ],
      "url": "https://www.facebook.com/164929129743/posts/10155892118379744"
    }
  ],
  "remaining": 12
}
```

### List profile labels

List the profile labels your Emplifi user can see, with the profiles each one is on.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back
- `labels` (list): The profile labels

**Example output**

```json
{
  "count": 1,
  "labels": [
    {
      "id": "ffc196eb056b42fd9b03",
      "name": "Europe",
      "profiles": [
        {
          "name": "Emplifi",
          "platform": "facebook"
        }
      ]
    }
  ]
}
```

### List profiles

List the profiles of one network connected to your Emplifi account, with their ids, handles, time zones and whether insights are on.

**Inputs**

- Network (`network`, text, required): The network whose connected profiles to list. One of: `facebook`, `instagram`, `twitter` (X (Twitter)), `youtube`, `linkedin`, `pinterest`, `tiktok`, `snapchat`, `whatsapp`, `googlebp` (Google Business Profile).

**Outputs**

- `count` (number): How many came back
- `profiles` (list): The profiles

**Example output**

```json
{
  "count": 1,
  "profiles": [
    {
      "community_enabled": true,
      "id": "164929129743",
      "insights_enabled": true,
      "name": "Emplifi",
      "picture": "https://example.cdn.com/picture.png",
      "platform": "facebook",
      "profile_name": "emplifi",
      "timezone": "America/Los_Angeles"
    }
  ]
}
```

### Remove labels from Community messages

Take labels off Community messages or posts.

**Inputs**

- Message IDs (`content_ids`, list, required): The Community messages or posts, each as its network, a dash and its id, such as facebook-849715935050458_1520511894637588. Build it from a Community message's platform and id.
- Labels (`labels`, list, required): The label names. A label that doesn't exist yet is created as a global label.

**Outputs**

- `count` (number): How many came back
- `labels` (list): The labels
- `results` (list): What happened to each message

**Example output**

```json
{
  "count": 1,
  "labels": [
    "Needs reply"
  ],
  "results": [
    {
      "content_id": "facebook-849715935050458_1520511894637588",
      "status": "ok"
    }
  ]
}
```

### Restore collection

Bring an archived collection back.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id.

**Outputs**

- `collection_id` (text): The collection's id
- `status` (text): ok when Emplifi made the change

**Example output**

```json
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}
```

### Update collection

Rename a collection, change its description, or share a private one with everyone in the account.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id.
- New name (`name`, text): The new name. Leave empty to keep it.
- New description (`description`, text): The new description. Leave empty to keep it.
- Share with everyone (`make_global`, true/false): Turn on to make a private collection global. It can't be made private again.

**Outputs**

- `collection_id` (text): The collection's id
- `status` (text): ok when Emplifi made the change

**Example output**

```json
{
  "collection_id": "g11N6XQBZejoR1EGGGq8",
  "status": "ok"
}
```
