Create a reaction on a post
Creates a new reaction on a post by the authenticated user. Returns a reaction object.
This endpoint only creates new reactions.
API keyYou will need to include your API key found here.
Please include the key in your header.
{"X-API-KEY": <api_key>}
Authorization requiredThis endpoint requires access to the board. You must have permission to interact with the board to create reactions.
Board support requiredReactions can only be created on boards that support reactions. The board must have the
Reactionfeature enabled.
An example of a basic request body is displayed below. It follows the JSON:API specification.
{
"data": {
"type": "reaction",
"attributes": {
"value": 1,
"reactionType": "like"
}
}
}Body parameters
* required
| Properties | Type | Description |
|---|---|---|
type* | string | Type should be set to reaction. |
attributes.value* | int | The reaction value. Valid values depend on the reaction type: • like: Must be |
attributes.reactionType | string | The type of reaction. Can be like, star, grade, or vote. If not provided, defaults to the board's configured reaction type. |
URL parameters
| Parameter | Type | Description |
|---|---|---|
post_id | string | The hash ID of the post to react to |
Validation rules
- The board must support reactions (
Reactionfeature enabled) - The reaction value must be valid for the specified reaction type
- The reaction type must match the board's configured reaction type (if not specified in request)
- Uniqueness constraint: Each user can only have one reaction per post. If the authenticated user already has a reaction on the specified post, this endpoint will return a 422 error instead of updating the existing reaction.
Example response
{
"data": {
"id": "reaction_abc123def456",
"type": "reaction",
"attributes": {
"value": 1,
"reactionType": "like",
"createdAt": "2025-07-01T10:30:00.000Z",
"updatedAt": "2025-07-01T10:30:00.000Z"
},
"relationships": {
"post": {
"data": {
"id": "post_lkROZPOe62X2QjMg",
"type": "post"
}
},
"board": {
"data": {
"id": "3pbz27udysdf57mg",
"type": "board"
}
}
}
}
}