Twitter Repost Scheduling API
Endpoint Details
POST https://portfolio.tigest.club/api/v1/dashboard/post/webhook
Content-Type: multipart/form-data
Request Parameters
Parameter | Type | Required | Description | Valid Values | Example |
---|---|---|---|---|---|
content | string | Yes | Additional comment for the repost (optional) | Text up to 280 characters | "" (empty for simple repost) |
channel | string | Yes | Target platform (always Twitter) | "Twitter" | ”Twitter” |
post_type | string | Yes | Type of content being posted | "repost" | ”repost” |
calendar_uuid | string | Yes | Unique identifier for your content calendar | Valid UUID format | ”69a1bf45-c48e-46cf-bd53-f47f3efa9763” |
scheduled_at | string | Yes | Publication date and time in ISO 8601 format | Future datetime in UTC | ”2025-05-30T21:30:00Z” |
status | string | Yes | Post publication status | "draft" , "published" , "scheduled" | ”draft” |
tweet_id | string | Yes | The ID of the tweet you want to repost | Valid 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
Field | Type | Description |
---|---|---|
id | integer | Unique numeric identifier for the repost |
uuid | string | Unique string identifier (use for API references) |
calendar_uuid | string | Links the repost to your content calendar |
calendar_user_uuid | string | Identifies the calendar owner |
content | string | Your additional commentary (empty for simple reposts) |
channel | string | Always “Twitter” for this endpoint |
images | array | Empty array (reposts don’t include new images) |
status | string | Current repost status (draft/scheduled/published) |
scheduled_at | string | Scheduled publication time in UTC |
created_at | string | Repost creation timestamp |
is_active | boolean | Whether the repost is active in the system |
updated_at | string | Last modification timestamp |
post_type | string | Always “repost” for this endpoint |
post_content | object | Contains the original tweet ID being reposted |
metadata | object | Additional metadata about the repost |
campaign_uuid | string | Associated campaign identifier (if any) |
analytics | object | Repost performance data (populated after publication) |
post_content Object
The post_content
object contains repost-specific information:
{
"tweet_id": "1926945210002493637"
}
Field | Type | Description |
---|---|---|
tweet_id | string | The 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