Twitter Comment with Images API

Creates a new Twitter comment with image attachments on an existing tweet. Each comment can include up to 4 media files, allowing for rich visual engagement and enhanced interaction.

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
`channel`	string	Yes	Target platform (always Twitter)	`"Twitter"`	”Twitter”
`post_type`	string	Yes	Type of content being posted	`"comment"`	”comment”
`content`	string	Yes	Text content of the comment	Up to 280 characters	”gm gm”
`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	ID of the tweet being commented on	Valid Twitter tweet ID	”1926945210002493637”
`images`	file	Optional	Image/video files for the comment	JPEG, PNG, GIF, WebP, MP4 (max 5MB each)	images0, images1, images2, etc.

Parameter Details

Content Guidelines:

Character Limit: Each comment must be 280 characters or less
Image Limits: Up to 4 images/videos per comment
Image Formats: JPEG, PNG, GIF, WebP, MP4 supported
File Size: Maximum 5MB per file
Image Quality: High-resolution images recommended for better engagement

Example Requests

Product Response Comment

curl --location 'https://portfolio.tigest.club/api/v1/dashboard/post/webhook' \
--header 'X-API-KEY: your_api_key_here' \
--form 'content="gm gm"' \
--form 'channel="Twitter"' \
--form 'post_type="comment"' \
--form 'scheduled_at="2025-05-30T21:30:00Z"' \
--form 'status="draft"' \
--form 'calendar_uuid="69a1bf45-c48e-46cf-bd53-f47f3efa9763"' \
--form 'images=@"/path/to/image1.gif"' \
--form 'images=@"/path/to/image2.jpg"' \
--form 'images=@"/path/to/video.mp4"' \
--form 'images=@"/path/to/image3.jpg"' \
--form 'tweet_id="1926945210002493637"'

Visual Response Comment

curl --location 'https://portfolio.tigest.club/api/v1/dashboard/post/webhook' \
--header 'X-API-KEY: your_api_key_here' \
--form 'content="Here'\''s a visual response to your question!"' \
--form 'channel="Twitter"' \
--form 'post_type="comment"' \
--form 'scheduled_at="2025-05-30T21:30:00Z"' \
--form 'status="draft"' \
--form 'calendar_uuid="69a1bf45-c48e-46cf-bd53-f47f3efa9763"' \
--form 'images=@"/path/to/diagram.png"' \
--form 'images=@"/path/to/example.gif"' \
--form 'tweet_id="1926945210002493637"'

Response Format

Successful Response

Status Code: 200 OK

{
  "data": {
    "id": 1074028,
    "uuid": "a25821ff-c92c-4676-940b-72b16baf67f4",
    "calendar_uuid": "69a1bf45-c48e-46cf-bd53-f47f3efa9763",
    "calendar_user_uuid": "cb3c071c-319a-4dfb-ab0c-538339d18325",
    "content": "gm gm",
    "channel": "Twitter",
    "images": [
      "https://tigestdashboard.blob.core.windows.net/dashboard/5f4d017c-3755-4aaf-aa9c-8ac3702167f2.gif",
      "https://tigestdashboard.blob.core.windows.net/dashboard/c6393c40-d512-4f16-bc7b-80a4fe09a91e.jpg",
      "https://tigestdashboard.blob.core.windows.net/dashboard/d49815ce-1d99-4a5a-a47d-721d0b3e3f8a.mp4",
      "https://tigestdashboard.blob.core.windows.net/dashboard/f8e20760-d556-4915-a585-8b55dd7d2feb.jpg"
    ],
    "status": "draft",
    "scheduled_at": "2025-05-30T21:30:00Z",
    "created_at": "2025-05-29T15:46:55.221517362Z",
    "is_active": true,
    "updated_at": "2025-05-29T15:46:55.221517362Z",
    "post_type": "comment",
    "post_content": {
      "text": "gm gm",
      "images": [
        "https://tigestdashboard.blob.core.windows.net/dashboard/5f4d017c-3755-4aaf-aa9c-8ac3702167f2.gif",
        "https://tigestdashboard.blob.core.windows.net/dashboard/c6393c40-d512-4f16-bc7b-80a4fe09a91e.jpg",
        "https://tigestdashboard.blob.core.windows.net/dashboard/d49815ce-1d99-4a5a-a47d-721d0b3e3f8a.mp4",
        "https://tigestdashboard.blob.core.windows.net/dashboard/f8e20760-d556-4915-a585-8b55dd7d2feb.jpg"
      ],
      "tweet_id": "1926945210002493637"
    },
    "metadata": {},
    "campaign_uuid": null,
    "analytics": {}
  },
  "success": true
}

Response Fields Explained

Field	Type	Description
`id`	integer	Unique numeric identifier for the comment
`uuid`	string	Unique string identifier (use for API references)
`calendar_uuid`	string	Links the comment to your content calendar
`calendar_user_uuid`	string	Identifies the calendar owner
`content`	string	The text content of the comment
`channel`	string	Always “Twitter” for this endpoint
`images`	array	Array of uploaded image/video URLs
`status`	string	Current comment status (draft/scheduled/published)
`scheduled_at`	string	Scheduled publication time in UTC
`created_at`	string	Comment creation timestamp
`is_active`	boolean	Whether the comment is active in the system
`updated_at`	string	Last modification timestamp
`post_type`	string	Always “comment” for this endpoint
`post_content`	object	Contains the complete comment structure and images
`metadata`	object	Additional metadata about the comment
`campaign_uuid`	string	Associated campaign identifier (if any)
`analytics`	object	Comment performance data (populated after publication)

Error Handling

Comment-Specific Errors

Invalid Tweet ID (Code: 4001)

{
  "errors": {
    "code": 4001,
    "message": "Invalid tweet ID. The tweet does not exist or is not accessible."
  },
  "success": false
}

Solution: Ensure the tweet ID is valid and the tweet is accessible.

Image Upload Failed (Code: 4007)

{
  "errors": {
    "code": 4007,
    "message": "One or more images failed to upload. Please check file formats and sizes."
  },
  "success": false
}

Solution: Verify image files are in supported formats (JPEG, PNG, GIF, WebP, MP4) and under 5MB each.

Character Limit Exceeded (Code: 4009)

{
  "errors": {
    "code": 4009,
    "message": "Comment exceeds 280 character limit."
  },
  "success": false
}

Solution: Ensure your comment text is 280 characters or less.

Too Many Images (Code: 4010)

{
  "errors": {
    "code": 4010,
    "message": "Comment exceeds maximum of 4 images/videos."
  },
  "success": false
}

Solution: Reduce the number of images/videos to 4 or fewer.

Last updated: May 29, 2025

Comment Without Image Quote Repost