Skip to main content
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

Response

Engagements created

engagements
object[]