> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sagepilot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get social activity

> List social comments and activity for a customer.

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "d4926456-6ce4-4d26-8d92-a871d914c459",
      "comment_content": "Hii",
      "created_at": "2025-10-17T14:19:37.669529Z",
      "post_caption": null,
      "post_type": "FEED",
      "channel_kind": "instagram"
    }
  ]
  ```
</ResponseExample>

Get social activity for a customer.

## Required access

| Authentication                                               | Scope            | Dataset grant |
| ------------------------------------------------------------ | ---------------- | ------------- |
| [API client v2](/api-reference/authentication/api-client-v2) | `customers:read` | `customers`   |

## Body

<ParamField body="customerId" type="string" required>
  Customer UUID to fetch social activity for. Open a customer in the Customer module and use the last UUID in the URL: `/dashboard/[workspace_id]/customers/[customer_id]`. See [Resource IDs](/api-reference/authentication/api-client-v2#resource-ids).
</ParamField>

<ParamField body="workspaceId" type="string">
  Optional workspace UUID. The authenticated workspace is used by default. Find the current workspace ID in **Settings > API Details > Channels**. See [Resource IDs](/api-reference/authentication/api-client-v2#resource-ids).
</ParamField>

<ParamField body="includeLinkedContacts" type="boolean" default="false">
  Include social activity from linked contacts.
</ParamField>

## Query parameters

<ParamField query="page" type="integer" default="1">
  Page number.
</ParamField>

<ParamField query="page_size" type="integer" default="20">
  Records per page. Maximum value is `200`.
</ParamField>

## Response

<ResponseField name="[]" type="object[]" required>
  Social activity records for the customer.
</ResponseField>