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
}

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

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