Skip to content
campaiDeveloper
campai.com

Crm · Social posts

GET/{organizationId}/crm/communication/socialPostsReads only

List social posts

Lists an organization’s social posts, scheduled posts or publication history. You can filter by status, account and media, choose the sort direction, and paginate the results. It returns a matching count and posts with account results, a thumbnail and aggregated likes, comments and views.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • The caller must have organization access and the social.read permission.

Request

Path parameters

  • organizationIdidrequired

Query parameters

  • viewstring

    default "all"

    all scheduled history
  • statusstring
    scheduled pending publishing processing published partiallyPublished failed unconfirmed
  • accountIdid
  • mediastring
    image video none
  • sortBystring

    default "desc"

    asc desc
  • offsetinteger

    at least 0 · default 0

  • limitinteger

    1–100 · default 30

Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request GET 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts' \
  --header 'X-API-Key: YOUR_API_KEY'

Response

200 Successful response

Content-Type: application/json

  • countinteger

    at least 0

  • postsobject[]
    9 properties
    • statusstring
      scheduled pending publishing processing published partiallyPublished failed unconfirmed
    • scheduledAtstring · date-timenullable
    • publicationDatestring · date-time
    • postIdid
    • textstring
    • mediaCountinteger

      at least 0

    • deliveriesobject[]
      9 properties
      • statusstring
        pending publishing processing published failed unconfirmed
      • urlstringnullable
      • errorDetailsobjectnullable
        6 properties
        • categorystring
          authentication permission validation rateLimit temporary unknown
        • actionstring
          reconnect reviewPermissions editPost retryLater checkPlatform contactSupport
        • codestringnullable
        • reasonstringnullable
          26 values
          apiQuota youtubeUploadLimit videoDuration mediaFormat invalidMedia videoFrameRate mediaDimensions mediaDownload uploadAborted mediaDomain privacySetting postingLimit accountRestricted duplicateVideo contentRights contentPolicy verifyEmail mediaType emptyPost unconfirmed platformRejected wordpressNotPublished containerFailed youtubeFailed facebookFailed tiktokFailed
        • stagestring
          preflight upload publish poll
        • occurredAtstring · date-time
      • publishedAtstring · date-timenullable
      • accountIdid
      • canRetryboolean
      • canCheckboolean
      • canRepublishboolean
      • canDismissboolean
    • thumbnailobjectnullable

      posts[].thumbnail is null when the post preview has no media.

      2 properties
      • urlstring
      • kindstring
        image video
    • statisticsobject
      3 properties
      • likesintegernullable

        posts[].statistics.likes is null while no listed account has reported the figure.

      • commentsintegernullable

        posts[].statistics.comments is null while no listed account has reported the figure.

      • viewsintegernullable

        posts[].statistics.views is null while no listed account has reported the figure.

Response200
{
  "count": 0,
  "posts": [
    {
      "status": "scheduled",
      "scheduledAt": "2026-06-15T22:30:00Z",
      "publicationDate": "2026-06-15T22:30:00Z",
      "postId": "000000000000000000000001",
      "text": "string",
      "mediaCount": 0,
      "deliveries": [
        {
          "status": "pending",
          "url": "string",
          "errorDetails": {
            "category": "authentication",
            "action": "reconnect",
            "code": "string",
            "reason": "apiQuota",
            "stage": "preflight",
            "occurredAt": "2026-06-15T22:30:00Z"
          },
          "publishedAt": "2026-06-15T22:30:00Z",
          "accountId": "000000000000000000000001",
          "canRetry": true,
          "canCheck": true,
          "canRepublish": true,
          "canDismiss": true
        }
      ],
      "thumbnail": {
        "url": "string",
        "kind": "image"
      },
      "statistics": {
        "likes": 1,
        "comments": 1,
        "views": 1
      }
    }
  ]
}

Errors

No errors of its own are known for this endpoint.

Errors nearly every request can meet are listed under Errors.