POSTENGAGEMENT: Post Engagement
The POSTENGAGEMENT entity represents records a user's intention to like, share, or comment on a scheduled social post. Created manually from the Shared Posts screen or automatically by auto-engagement rules.
Default definition. This article describes the default
POSTENGAGEMENT definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches POSTENGAGEMENT.Entity properties
| Property | Value |
|---|---|
| Entity code | POSTENGAGEMENT |
| Display name | Post Engagement |
| Plural | Post Engagements |
| Level | 810 |
Use cases
General-purpose post engagements records. Records a user's intention to like, share, or comment on a scheduled social post. Created manually from the Shared Posts screen or automatically by auto-engagement rules.
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
userId | reference → user | User. Read-only. | |
post | reference → POST | Post. Read-only. | |
postName | text (multi-line) | Post content. Read-only. | |
socialChannel | reference → SOCIALCHANNEL | Channel. Read-only. | |
language | text | Language. Read-only. | |
posttime | datetime | Post time. Read-only. | |
doLike | boolean | Like. | |
doShare | boolean | Share. | |
doComment | boolean | Comment. | |
commentText | text (multi-line) | Comment text. | |
shareText | text (multi-line) | Share text. | |
status | enum | Status. Valid ids: pending (Pending), applied (Applied), failed (Failed). | |
autoGenerated | boolean | Auto-generated. Read-only. |
Relationships
- Lookups:
postpoints atPOSTrecord;socialChannelpoints atSOCIALCHANNELrecord.
Creating a Post Engagement via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "POSTENGAGEMENT",
"level": 810,
"comboKey": "SUB:<your-sub-id>|ENT:",
"doLike": true,
"doShare": true,
"doComment": true,
"commentText": "Long description text."
}Listing POSTENGAGEMENT records
# All post engagements in your tenant
GET /v1/entities/POSTENGAGEMENT/SUB