Create for a post

curl --request POST \
  --url https://app.tryordinal.com/api/v1/posts/{postId}/engagements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel": "LinkedIn",
  "engagements": [
    {
      "type": "Like",
      "profileId": "550e8400-e29b-41d4-a716-446655440001",
      "reactionType": "Celebrate"
    },
    {
      "type": "Comment",
      "profileId": "550e8400-e29b-41d4-a716-446655440002",
      "copy": "Great insights! Check out our guide for more details.",
      "delaySeconds": 300
    },
    {
      "type": "Repost",
      "profileId": "550e8400-e29b-41d4-a716-446655440003",
      "delaySeconds": 3600
    }
  ]
}
'

{
  "engagements": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440800",
      "type": "Like",
      "profileId": "550e8400-e29b-41d4-a716-446655440001",
      "copy": null,
      "delaySeconds": 0,
      "reactionType": "Celebrate"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440801",
      "type": "Comment",
      "profileId": "550e8400-e29b-41d4-a716-446655440002",
      "copy": "Great insights! Check out our guide for more details.",
      "delaySeconds": 300
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440802",
      "type": "Repost",
      "profileId": "550e8400-e29b-41d4-a716-446655440003",
      "copy": null,
      "delaySeconds": 3600
    }
  ]
}

Engagements

Create for a post

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 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

POST

posts

{postId}

engagements

Create for a post

curl --request POST \
  --url https://app.tryordinal.com/api/v1/posts/{postId}/engagements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel": "LinkedIn",
  "engagements": [
    {
      "type": "Like",
      "profileId": "550e8400-e29b-41d4-a716-446655440001",
      "reactionType": "Celebrate"
    },
    {
      "type": "Comment",
      "profileId": "550e8400-e29b-41d4-a716-446655440002",
      "copy": "Great insights! Check out our guide for more details.",
      "delaySeconds": 300
    },
    {
      "type": "Repost",
      "profileId": "550e8400-e29b-41d4-a716-446655440003",
      "delaySeconds": 3600
    }
  ]
}
'

{
  "engagements": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440800",
      "type": "Like",
      "profileId": "550e8400-e29b-41d4-a716-446655440001",
      "copy": null,
      "delaySeconds": 0,
      "reactionType": "Celebrate"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440801",
      "type": "Comment",
      "profileId": "550e8400-e29b-41d4-a716-446655440002",
      "copy": "Great insights! Check out our guide for more details.",
      "delaySeconds": 300
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440802",
      "type": "Repost",
      "profileId": "550e8400-e29b-41d4-a716-446655440003",
      "copy": null,
      "delaySeconds": 3600
    }
  ]
}

Authorizations

Authorization

string

header

required

API key authentication. Generate an API key from your workspace settings.

Path Parameters

postId

string<uuid>

required

Post ID (UUID)

Body

application/json

channel

enum<string>

required

Available options:

LinkedIn,

Twitter

engagements

object[]

required

Minimum array length: 1

Show child attributes

Response

Engagements created

engagements

object[]

Show child attributes

List for a post Delete an engagement

⌘I