Skip to content
campaiDeveloper
campai.com

Crm ยท Social posts

POST/{organizationId}/crm/communication/socialPosts/{postId}/deliveries/{accountId}/retry

Retry post delivery

Retries a failed delivery, checks an unconfirmed operation without resubmitting it, or republishes an unconfirmed publication after the caller verifies it is not live. It takes an organization, post and account ID plus an action of retry, check or republish. It updates the delivery and returns postId.

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 with the social.edit permission.

Request

Path parameters

  • organizationIdidrequired
  • postIdidrequired
  • accountIdidrequired

Body

Content-Type: application/json

  • actionstringrequired
    retry check republish
Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request POST 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts/YOUR_POST_ID/deliveries/YOUR_ACCOUNT_ID/retry' \
  --header 'X-API-Key: YOUR_API_KEY'

No request that worked has been recorded yet, so the body is not shown.

Response

200 Successful response

Content-Type: application/json

  • postIdid
Response200
{
  "postId": "000000000000000000000001"
}

What else happens

  • The endpoint updates the delivery and recalculates the post's status and publication date.
  • If no deliveries still need attention, matching post notifications are deleted.
  • When unread notifications are cleared, their users' notification watch counters are decremented and marked for reconciliation.
  • The endpoint submits a crm.processSocialPost job to DefaultQueue. If submission fails, the saved retry is left for recovery.

Errors

Other errors

StatusErrorWhen
400Reconnect this account to renew its authorization.If the account is not connected in the organization, the endpoint returns 400 with socialProvider.reconnectRequired.
404No fixed messageIf the post is not found in the organization, the endpoint returns 404.
404No fixed messageIf the post has no delivery for the account, the endpoint returns 404.
409This publication can no longer be retried or checked. Refresh its status.If the requested action is not allowed for the delivery, the endpoint returns 409 with socialPost.deliveryNotRetryable.

Errors nearly every request can meet are listed under Errors.