Get Suggested Post Slot

​

Behavior

• Candidate times are the posting times set for these accounts in the Genviral Social Hub (the same posting_times that Get Accounts returns), combined across all named accounts. When none of them has posting times, the candidate is 12:00 each day.
• Posting times are wall-clock times. They are read in the timezone you send, so 09:00 means 9 in the morning in that zone.
• The search starts today in that zone and never suggests a time less than two minutes from now.
• A time is skipped when one of these accounts already has a post scheduled in that same minute. skipped_conflicts counts the skipped times.
• Every account must belong to the key scope (workspace accounts for a workspace key, personal accounts for a personal key) and be active. Otherwise the request fails with 400 validation_failed.

​

Query Parameters

​

Response

curl --request GET \
  --url 'https://www.genviral.io/api/partner/v1/posts/suggested-slot?account_ids=0f4f54d4-8cce-4fb7-8c7b-befbcb8af812,54c22677-43f4-415f-a820-7dfd1fcd4bd5&timezone=Europe/Amsterdam' \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Suggested slot retrieved",
  "data": {
    "scheduled_at": "2026-10-03T07:00:00.000Z",
    "source": "account_posting_times",
    "skipped_conflicts": 1,
    "timezone": "Europe/Amsterdam"
  }
}

{
  "ok": false,
  "code": 400,
  "message": "No time could be suggested. Check that every account is connected and active in this space.",
  "error_code": "validation_failed"
}

​

Error Responses

• 400 validation_failed - one or more accounts are outside the key scope or are not active
• 401 - authentication failed (missing, invalid, or revoked token)
• 422 invalid_payload - account_ids or timezone is missing or invalid; fields names each one
• 500 - unexpected error while computing the suggestion