Skip to main content
Back to API docs

Post status tracking

Track Social Post Status with Wahdx Connection API

Status tracking closes the loop after a publishing request. Teams need to know whether a post is still queued, currently processing, already published, or requires attention. Wahdx Connection supports individual and batch-style status workflows so backend integrations and content teams can keep operational visibility.

Single status check

Use account and publish identifiers to check a specific post. For TikTok, include mediaType when needed to resolve the correct public post URL behavior.

const API_BASE_URL = 'https://api.wahdx.com';
const API_KEY = process.env.WAHDX_API_KEY;

await fetch(API_BASE_URL + '/api/content/status/{accountId}/{publishId}?mediaType=video', {
  method: 'GET',
  headers: {
    'X-API-Key': API_KEY
  }
});

Batch status check

Batch checks are useful when your system monitors multiple posts after scheduling or publishing requests.

const API_BASE_URL = 'https://api.wahdx.com';
const API_KEY = process.env.WAHDX_API_KEY;

await fetch(API_BASE_URL + '/api/content/status/batch', {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    checks: [
      { accountId: 'ACCOUNT_ID_1', publishId: 'PUBLISH_ID_1', mediaType: 'video' },
      { accountId: 'ACCOUNT_ID_2', publishId: 'PUBLISH_ID_2' }
    ]
  })
});

Operational states to monitor

Design your integration to surface status clearly to content operators.

  • Queued: content is waiting to be processed.
  • Processing: the publishing workflow is running.
  • Published: content has completed successfully.
  • Failed: the team should review and resolve the issue.

FAQ

Common questions about this API topic.

Can I check more than one post status?

Yes. Use the batch status endpoint when your backend needs to monitor multiple posts.

Why should I include mediaType for TikTok checks?

It helps the API return the correct status and public post URL behavior for video or photo workflows.

Who should use status tracking?

Agencies, brands, and backend integrations that need reliable publishing visibility should use status tracking.