/v1/communities/{community_id}/conversations/{conversation_id}/messages/{message_id}/reactionsAuthAdd a reaction to a direct message. Idempotent — re-posting the same (actor, type) is a no-op.
Path parameters
community_id*stringSocial community UUID.
conversation_id*stringConversation UUID.
message_id*stringDirect message UUID.
Headers
Idempotency-KeystringOpaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.
Request body
actor_id*string · uuidThe reactor — social actor UUID. Standardized name (task 008 / G11).
Example: "aaaaaaaa-0000-0000-0000-000000000001"
type*stringReaction type (emoji or label, 1..64 chars).
Example: "heart"
Response · 201 Reaction applied (created or pre-existing).
reaction*objectmessage_id*string · uuidReacted message UUID.
Example: "eeeeeeee-0000-0000-0000-000000000001"
actor_id*string · uuidReactor actor UUID.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
community_id*string · uuidOwning community UUID.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
type*stringReaction type (emoji or label, 1..64 chars).
Example: "heart"
created_at*string · date-timeISO timestamp.
Example: "2026-05-01T12:00:00.000Z"
created*booleanTrue when this call inserted the row; false on idempotent retry.
Example: true
reaction_counts*objectDenormalised map of reaction type → count after the change.
Example: {"heart":3,"laugh":1}
Example
Request
POST https://social.productcraft.co/v1/communities/{community_id}/conversations/{conversation_id}/messages/{message_id}/reactions
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
"type": "heart"
}Response
{
"reaction": {
"message_id": "eeeeeeee-0000-0000-0000-000000000001",
"actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"type": "heart",
"created_at": "2026-05-01T12:00:00.000Z"
},
"created": true,
"reaction_counts": {
"heart": 3,
"laugh": 1
}
}