---
title: "profile.stats"
method: POST
path: "profile.stats"
---

# profile.stats

`POST profile.stats` (webhook)

A new profile stats snapshot was recorded (fires once per placement).

## Payload

- WebhookEventProfileStats: Envelope shared by every webhook delivery.
  - `id` string, required: Delivery ID, prefixed with whevt_. Matches the X-Postproxy-Delivery header.
  - `object` 'event', required: Always "event".
  - `type` string, required: Event type (e.g. platform_post.published). Matches the X-Postproxy-Event header.
  - `created_at` string, required: ISO 8601 timestamp of when the event was generated.
  - `data` object, required: Container for the event-specific resource.
    - `object` object: Profile stats snapshot. Snapshots are captured roughly every 23 hours per profile; for networks with placements the event fires once per placement on each polling cycle.
      - `profile_id` string: Profile ID.
      - `platform` string: Network name (e.g. linkedin, bluesky).
      - `placement_id` string, nullable: Platform-specific placement ID. null for networks without placements.
      - `stats` object: Platform-specific metrics. Shape varies by network.
      - `recorded_at` string: ISO 8601 timestamp when the snapshot was captured.

## Acknowledgement `200`

Acknowledged

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)
