Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

Save content post

POST /api/v1/content/posts

Save caller-authored LinkedIn content as a draft. This operation cannot schedule or publish.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

linkedinAccountIdrequired

string

No description.

topic

string

No description.

postTyperequired

string

No description.

thought_leadership | lead_magnet | case_study | personal_story

hookrequired

string

No description.

bodyrequired

string

No description.

cta

string

No description.

fullPostrequired

string

No description.

pinComment

string

No description.

idempotencyKey

string

Caller-stable key for retry-safe draft creation.

Example

REST requestbash

curl -X POST "https://app.pipeline.help/api/v1/content/posts" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedinAccountId":"00000000-0000-4000-8000-000000000000","postType":"thought_leadership","hook":"example","body":"example","fullPost":"example"}'

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "workspaceId": {
          "type": "string"
        },
        "linkedinAccountId": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "draft",
            "approved",
            "scheduled",
            "publishing",
            "published",
            "failed",
            "archived"
          ]
        }
      },
      "required": [
        "id",
        "workspaceId",
        "linkedinAccountId",
        "status"
      ]
    }
  },
  "required": [
    "success",
    "data"
  ]
}

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.