Skip to main content
POST
/
ideas
Create idea
curl --request POST \
  --url https://app.tryordinal.com/api/v1/ideas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "My Idea",
  "linkedIn": {
    "copy": "This is my idea content for LinkedIn"
  }
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://app.tryordinal.com/workspace/ideas/550e8400-e29b-41d4-a716-446655440000",
  "title": "My Idea",
  "channels": [
    "LinkedIn"
  ],
  "status": "Idea",
  "createdAt": "2026-02-18T14:30:00.000Z",
  "updatedAt": "2026-02-18T14:30:00.000Z",
  "linkedIn": {
    "copy": "This is my idea content for LinkedIn",
    "assets": []
  },
  "x": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.tryordinal.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Body

application/json
title
string
required

Idea title

labelIds
string<uuid>[]

Label IDs to attach to the idea

campaignId
string<uuid>

Campaign ID to link the idea to

linkedIn
object

LinkedIn channel configuration

x
object

X (Twitter) channel configuration

tikTok
object

TikTok channel configuration for creating or updating posts. TikTok posts require exactly one video asset.

youTubeShorts
object

YouTube Shorts channel configuration for creating or updating posts. YouTube Shorts posts require exactly one video asset (1s–3min).

notes
string

Internal notes for the idea

Response

Idea created successfully

Response when creating an idea

id
string<uuid>
url
string<uri>
title
string
channels
string[]
status
string
createdAt
string<date-time>
updatedAt
string<date-time>
linkedIn
object
x
object
tikTok
object

TikTok content. Present when the post targets the TikTok channel.

youTubeShorts
object

YouTube Shorts content. Present when the post targets the YouTube Shorts channel.