Crm ยท Social posts
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.editpermission.
Request
Path parameters
-
organizationIdidrequired -
postIdidrequired -
accountIdidrequired
Body
Content-Type: application/json
-
actionstringrequiredretrycheckrepublish
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'const response = await fetch("https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts/YOUR_POST_ID/deliveries/YOUR_ACCOUNT_ID/retry", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY"
},
redirect: 'error',
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(`campai HTTP ${response.status}`);
const text = await response.text();
const result = text ? JSON.parse(text) : null;
console.log(JSON.stringify(result, null, 2));<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => [
'X-API-Key: YOUR_API_KEY',
],
'timeout' => 30,
'follow_location' => 0,
'ignore_errors' => true,
]]);
$text = @file_get_contents('https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/crm/communication/socialPosts/YOUR_POST_ID/deliveries/YOUR_ACCOUNT_ID/retry', false, $context);
preg_match('/^HTTP\/\S+ (\d{3})/', $http_response_header[0] ?? '', $match);
$status = (int) ($match[1] ?? 0);
if ($text === false || $status < 200 || $status >= 300) {
throw new RuntimeException("campai HTTP $status (0 means no response)");
}
$result = $text === '' ? null : json_decode($text, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
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.processSocialPostjob toDefaultQueue. If submission fails, the saved retry is left for recovery.
Errors
Other errors
| Status | Error | When |
|---|---|---|
| 400 | Reconnect this account to renew its authorization. | If the account is not connected in the organization, the endpoint returns 400 with socialProvider.reconnectRequired. |
| 404 | No fixed message | If the post is not found in the organization, the endpoint returns 404. |
| 404 | No fixed message | If the post has no delivery for the account, the endpoint returns 404. |
| 409 | This 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.