APIsPostRepost

Twitter Repost Scheduling API

Endpoint Details

POST https://portfolio.tigest.club/api/v1/dashboard/post/webhook

Content-Type: multipart/form-data

Request Parameters

ParameterTypeRequiredDescriptionValid ValuesExample
contentstringYesAdditional comment for the repost (optional)Text up to 280 characters"" (empty for simple repost)
channelstringYesTarget platform (always Twitter)"Twitter"”Twitter”
post_typestringYesType of content being posted"repost"”repost”
calendar_uuidstringYesUnique identifier for your content calendarValid UUID format”69a1bf45-c48e-46cf-bd53-f47f3efa9763”
scheduled_atstringYesPublication date and time in ISO 8601 formatFuture datetime in UTC”2025-05-30T21:30:00Z”
statusstringYesPost publication status"draft", "published", "scheduled"”draft”
tweet_idstringYesThe ID of the tweet you want to repostValid Twitter tweet ID”1926945210002493637”

Example Requests

Simple Repost Without Commentary

curl --location 'https://portfolio.tigest.club/api/v1/dashboard/post/webhook' \
--header 'X-API-KEY: your_api_key_here' \
--header 'Content-Type: multipart/form-data' \
--form 'content=""' \
--form 'channel="Twitter"' \
--form 'post_type="repost"' \
--form 'scheduled_at="2025-05-30T21:30:00Z"' \
--form 'status="scheduled"' \
--form 'calendar_uuid="69a1bf45-c48e-46cf-bd53-f47f3efa9763"' \
--form 'tweet_id="1926945210002493637"'

Repost with Additional Commentary

curl --location 'https://portfolio.tigest.club/api/v1/dashboard/post/webhook' \
--header 'X-API-KEY: your_api_key_here' \
--header 'Content-Type: multipart/form-data' \
--form 'content="This is exactly what we need in the industry! 👏 Great insights from @originalauthor #Innovation #TechTrends"' \
--form 'channel="Twitter"' \
--form 'post_type="repost"' \
--form 'scheduled_at="2025-05-31T15:00:00Z"' \
--form 'status="scheduled"' \
--form 'calendar_uuid="69a1bf45-c48e-46cf-bd53-f47f3efa9763"' \
--form 'tweet_id="1926945210002493637"'

Response Format

Successful Response

Status Code: 200 OK

{
  "data": {
    "id": 1074009,
    "uuid": "845fac47-75bd-4a73-8d28-28da071395b4",
    "calendar_uuid": "69a1bf45-c48e-46cf-bd53-f47f3efa9763",
    "calendar_user_uuid": "cb3c071c-319a-4dfb-ab0c-538339d18325",
    "content": "",
    "channel": "Twitter",
    "images": [],
    "status": "draft",
    "scheduled_at": "2025-05-30T21:30:00Z",
    "created_at": "2025-05-29T15:08:16.96399929Z",
    "is_active": true,
    "updated_at": "2025-05-29T15:08:16.96399929Z",
    "post_type": "repost",
    "post_content": {
      "tweet_id": "1926945210002493637"
    },
    "metadata": {},
    "campaign_uuid": null,
    "analytics": {}
  },
  "success": true
}

Response Fields Explained

FieldTypeDescription
idintegerUnique numeric identifier for the repost
uuidstringUnique string identifier (use for API references)
calendar_uuidstringLinks the repost to your content calendar
calendar_user_uuidstringIdentifies the calendar owner
contentstringYour additional commentary (empty for simple reposts)
channelstringAlways “Twitter” for this endpoint
imagesarrayEmpty array (reposts don’t include new images)
statusstringCurrent repost status (draft/scheduled/published)
scheduled_atstringScheduled publication time in UTC
created_atstringRepost creation timestamp
is_activebooleanWhether the repost is active in the system
updated_atstringLast modification timestamp
post_typestringAlways “repost” for this endpoint
post_contentobjectContains the original tweet ID being reposted
metadataobjectAdditional metadata about the repost
campaign_uuidstringAssociated campaign identifier (if any)
analyticsobjectRepost performance data (populated after publication)

post_content Object

The post_content object contains repost-specific information:

{
  "tweet_id": "1926945210002493637"
}
FieldTypeDescription
tweet_idstringThe ID of the original tweet being reposted

Error Handling

Common Error Codes

Past Date Scheduling (Code: 4001)

{
  "errors": {
    "code": 4001,
    "message": "Oops! You can't schedule a post in the past. Please choose a future date and time."
  },
  "success": false
}

Repost Creation Failed (Code: 4005)

{
  "errors": {
    "code": 4005,
    "message": "We hit a snag while creating your repost. Mind trying again?"
  },
  "success": false
}

Additional Error Scenarios

Invalid Tweet ID

Solution: Ensure the tweet_id is a valid Twitter tweet ID and the original tweet is publicly accessible.

Tweet Not Found

Solution: Verify the tweet exists and hasn’t been deleted. Check if the original tweet is still publicly available.

Last updated: May 29, 2025