> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/objects/activity-post.md).

# The activity post object

The activity post object in the Shortcut API - every field, an example, and the endpoints that return it.

A post on a customer's activity feed: a comment, call summary, or photos and files.

## Fields

| Field             | Type                                                                                                                | Description                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `id`              | id                                                                                                                  | The post's id.                                                                        |
| `object`          | `"activity_post"`                                                                                                   | Always `activity_post`.                                                               |
| `customerId`      | id or null                                                                                                          | The customer the post is on.                                                          |
| `leadId`          | id or null                                                                                                          | The lead it was written on, for posts from before the lead became a customer.         |
| `body`            | string                                                                                                              | The post's text; empty for a post that is only photos or files.                       |
| `authorName`      | string or null                                                                                                      | Who posted it.                                                                        |
| `flaggedNegative` | boolean                                                                                                             | Whether it records a bad interaction, which counts toward the customer being at risk. |
| `attachments`     | array of [attachment](https://docs.shortcutco.com/developers/api-reference/reference/objects/attachment.md) objects | Photos, videos, and files on the post, in order.                                      |
| `createdAt`       | timestamp                                                                                                           | When it was posted, ISO 8601 in UTC.                                                  |
| `editedAt`        | timestamp or null                                                                                                   | When it was last edited.                                                              |

## Example

```json
{
  "id": "4bf60f69-4840-4ab0-848a-85f740d4c13e",
  "object": "activity_post",
  "customerId": "4ee367e9-4b2d-4330-8777-de7743c219be",
  "leadId": "bcc4d33b-b90f-4e82-8559-49c9b1a38510",
  "body": "Example body",
  "authorName": "Example authorName",
  "flaggedNegative": true,
  "attachments": [
    {
      "id": "4e574001-4aa1-4b48-86eb-b68f4335f1d6",
      "object": "attachment",
      "source": "activity_post",
      "type": "photo",
      "filename": "Example filename",
      "mimeType": "Example mimeType",
      "sizeBytes": 1,
      "durationSeconds": 1,
      "createdAt": "2026-10-16T17:04:12.381Z",
      "downloadUrl": "https://example.com/shortcut/webhooks",
      "downloadUrlExpiresAt": "2026-10-16T17:04:12.381Z"
    }
  ],
  "createdAt": "2026-10-16T17:04:12.381Z",
  "editedAt": null
}
```

## Endpoints

| Endpoint                                 | What it does                       |
| ---------------------------------------- | ---------------------------------- |
| `GET /v1/activity-posts/{id}`            | Get an activity post               |
| `PATCH /v1/activity-posts/{id}`          | Edit an activity post              |
| `GET /v1/customers/{id}/activity-posts`  | List a customer's activity posts   |
| `POST /v1/customers/{id}/activity-posts` | Post to a customer's activity feed |
