Skip to main content
WEBHOOK
realtimeWebhookEvent
{
  "type": "realtime.chat_message.received",
  "timestamp": "2026-04-23T14:30:15.143Z",
  "data": {
    "connection": {
      "id": "conn_example123",
      "clientReferenceId": "client_ref_123"
    },
    "environment": "live",
    "eventBody": {
      "id": 1002003004005,
      "queueId": 2003004005006,
      "responseType": "message",
      "text": "<p>Hello there</p>",
      "price": 0,
      "isFree": true,
      "isTip": false,
      "isNew": true,
      "isOpened": false,
      "isFromQueue": false,
      "isMediaReady": true,
      "mediaCount": 0,
      "createdAt": "2026-01-15T10:30:14+00:00",
      "changedAt": "2026-01-15T10:30:14+00:00",
      "cancelSeconds": 120,
      "fromUser": {
        "id": 123456789,
        "name": "Example User",
        "username": "example.user",
        "isVerified": false,
        "lastSeen": "2026-01-15T10:30:14+00:00"
      },
      "media": [],
      "previews": []
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ofauth.com/llms.txt

Use this file to discover all available pages before exploring further.

Realtime OnlyFans Events is the webhook surface for receiving supported translated OnlyFans events in your webhook endpoint.
Beta status: The translated webhook contract is stable, but the set of documented event categories may continue to expand over time.

​
What Is Stable

  • Each delivery uses a specific realtime.* event type
  • data.eventBody contains the translated event payload
  • data.connection and data.environment are always present
  • New event categories may be added during the beta

​
How To Integrate

  1. Verify the webhook signature on the raw request body.
  2. Route incoming deliveries by the top-level type.
  3. Parse data.eventBody defensively.
  4. Tolerate additional event categories appearing over time during the beta.

​
Documented Event Schemas

The schema pages below are generated from the same OpenAPI spec as the webhook contract:

​
Notes

  • The schema pages below describe currently documented event categories.
  • The translated webhook schema is the supported public contract for these events.
  • Fields may be added over time as beta coverage expands.

Body

application/json

Delivered when OFAuth observes a typing indicator update.

​
type
enum<string>
required
Available options:
realtime.chat_typing.updated
​
timestamp
string<date-time>
required

Webhook publication timestamp.

​
data
Chat typing updated · object
required

Delivered when OFAuth observes a typing indicator update.

Example:
{
  "connection": {
    "id": "conn_example123",
    "clientReferenceId": "client_ref_123"
  },
  "environment": "live",
  "eventBody": { "id": 123456789 }
}

Response

200

Return any 2xx response promptly after accepting the event.