Skip to content
campaiDeveloper
campai.com

Crm · Social posts

GET/{organizationId}/crm/communication/socialPosts/calendarReads only

Get publishing calendar

Returns a page of social posts and their per-account results, ordered by publication time. Provide an organization ID, ISO date-time from and to values, and an optional nonnegative offset that defaults to 0. The date range must be greater than zero and no longer than 32 days; to is exclusive. Each page contains up to 100 posts and a hasMore flag.

Permissions

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

Who may call it

  • Organization access with the social.read permission is required.

Request

Path parameters

  • organizationIdidrequired

Query parameters

  • fromstring · date-timerequired
  • tostring · date-timerequired
  • offsetinteger

    at least 0 · default 0

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/calendar' \
  --header 'X-API-Key: YOUR_API_KEY'

Response

200 Successful response

Content-Type: application/json

  • postsobject[]
    7 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
  • hasMoreboolean
Response200
{
  "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
        }
      ]
    }
  ],
  "hasMore": true
}

Errors

No errors of its own are known for this endpoint.

Errors nearly every request can meet are listed under Errors.