---
title: "Create for a post"
method: POST
path: "/posts/{postId}/engagements"
tags: ["Engagements"]
---

# Create for a post

`POST /posts/{postId}/engagements`

Add engagements (likes, comments, reposts) to a post. Engagements will be executed automatically when the post is published.

**Tagging on LinkedIn:**
To mention someone in a comment or repost, use the format `@[Display Name](urn)`. See [LinkedIn Mentions](/api/linkedin-mentions) for details on how to look up URNs.

**LinkedIn reaction types:**
For Like engagements on LinkedIn, you can specify a reaction type (Like, Celebrate, Love, Insightful, Support, Funny). Defaults to Like if not specified. Must not be provided for Comment or Repost.

**Validation rules:**
- `copy` is required for Comment, optional for Repost, must not be provided for Like
- `delaySeconds` is required for Comment and Repost (any integer from 0 to 86400 — up to 24 hours), must not be provided for Like
- `reactionType` is only for Like engagements on LinkedIn (defaults to Like if omitted)
- Only one Like engagement per profile is allowed

## Path parameters

- `postId` string, uuid, required

## Request body

- CreateEngagementsInput
  - `channel` 'LinkedIn' | 'Twitter', required
  - `engagements` EngagementInput[], required
    - `type` 'Like' | 'Comment' | 'Repost', required
    - `profileId` string, uuid, required — The profile ID that will perform the engagement
    - `copy` string — The text content. Required for Comment, optional for Repost, must not be provided for Like.
    - `delaySeconds` integer — Delay in seconds after the post publishes. Accepts any integer from 0 to 86400 (24 hours). Required for Comment and Repost, must not be provided for Like.
    - `reactionType` 'Like' | 'Celebrate' | 'Love' | 'Insightful' | 'Support' | 'Funny' — LinkedIn reaction type for Like engagements. Only applicable when type is Like and channel is LinkedIn. Defaults to Like if not specified.

## Response `200`

Engagements created

- object
  - `engagements` Engagement[]
    - `id` string, uuid
    - `channel` 'LinkedIn' | 'Twitter'
    - `type` 'Like' | 'Comment' | 'Repost'
    - `profileId` string, uuid — The profile ID that will perform the engagement
    - `copy` string, nullable — The text content for Comment or Repost engagements. Required for Comment, optional for Repost, must not be provided for Like.
    - `delaySeconds` integer — Delay in seconds after the post publishes. For Comment and Repost, this is the delay until the engagement fires (0 means immediate). Always 0 for Like.
    - `reactionType` 'Like' | 'Celebrate' | 'Love' | 'Insightful' | 'Support' | 'Funny' — LinkedIn reaction type for Like engagements. Only applicable when type is Like and channel is LinkedIn. Defaults to Like if not specified.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid API key
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/tryordinal/apis/ordinal-api.md) · [All operations](https://skmtc.net/tryordinal/apis/ordinal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryordinal/ordinal-api/revisions/1d0792ff454f/schema)