Skip to content
campaiDeveloper
campai.com

Crm · Social posts

GET/{organizationId}/crm/communication/socialPosts/{postId}Reads only

Get social post

Gets a social post by organization ID and post ID, including each account's publication result and any collected statistics. The response includes signed media URLs. Set includeMediaMetadata to true to request media sizes; it defaults to false.

Permissions

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

Who may call it

  • Organization access and the social.read permission are required.

Request

Path parameters

  • organizationIdidrequired
  • postIdidrequired

Query parameters

  • includeMediaMetadataboolean

    default false

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

Response

200 Successful response

Content-Type: application/json

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

    at least 0

  • deliveriesobject[]
    13 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
    • textstringnullable
    • mediaobject[]nullable
      5 properties
      • resourcestring

        at least 1 characters

      • mimeTypestring

        at least 1 characters

      • kindstring
        image video
      • urlstring
      • sizenumbernullable
    • settingsobject
      8 properties
      • titlestringnullable
      • boardIdstringnullable
      • privacystringnullable
      • disableCommentboolean
      • disableDuetboolean
      • disableStitchboolean
      • brandContentboolean
      • brandOrganicboolean
    • statisticsobjectnullable

      deliveries[].statistics is null when there is no statistics record for the account.

      5 properties
      • statusstring
        pending available missingPermission notFound unsupported failed
      • metricsobject
        7 properties
        • viewsintegernullable

          at least 0

        • reachintegernullable

          at least 0

        • likesintegernullable

          at least 0

        • commentsintegernullable

          at least 0

        • sharesintegernullable

          at least 0

        • savesintegernullable

          at least 0

        • clicksintegernullable

          at least 0

      • fetchedAtstring · date-timenullable
      • refreshableAtstring · date-timenullable

        deliveries[].statistics.refreshableAt is null when statistics cannot be refreshed manually.

      • refreshingboolean
  • mediaobject[]
    5 properties
    • resourcestring

      at least 1 characters

    • mimeTypestring

      at least 1 characters

    • kindstring
      image video
    • urlstring
    • sizenumbernullable

      media[].size and deliveries[].media[].size are null when media metadata is not requested, the metadata lookup fails, or it has no content length.

Response200
{
  "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,
      "text": "string",
      "media": [
        {
          "resource": "string",
          "mimeType": "string",
          "kind": "image",
          "url": "string",
          "size": 1
        }
      ],
      "settings": {
        "title": "string",
        "boardId": "string",
        "privacy": "string",
        "disableComment": true,
        "disableDuet": true,
        "disableStitch": true,
        "brandContent": true,
        "brandOrganic": true
      },
      "statistics": {
        "status": "pending",
        "metrics": {
          "views": 0,
          "reach": 0,
          "likes": 0,
          "comments": 0,
          "shares": 0,
          "saves": 0,
          "clicks": 0
        },
        "fetchedAt": "2026-06-15T22:30:00Z",
        "refreshableAt": "2026-06-15T22:30:00Z",
        "refreshing": true
      }
    }
  ],
  "media": [
    {
      "resource": "string",
      "mimeType": "string",
      "kind": "image",
      "url": "string",
      "size": 1
    }
  ]
}

Errors

Other errors

StatusErrorWhen
404No fixed messageReturns HTTP 404 if the post is not found in the organization.

Errors nearly every request can meet are listed under Errors.