Tareno API Documentation

Retrieve all connected social media accounts.

Response Example:

{
  "accounts": [
    {
      "id": "uuid-here",
      "platform": "instagram",
      "username": "yourhandle",
      "displayName": "Your Name",
      "profilePicture": "https://..."
    }
  ]
}

Publish or schedule a post to social media.

Request Body:

{
  "accountId": "uuid-of-account",
  "text": "Your post caption",
  "mediaUrls": ["https://example.com/image.jpg"],
  "scheduledAt": "2026-01-15T10:00:00Z",  // Optional
  "timezone": "Europe/Berlin",             // Optional
  "metadata": {
    "format": "post",                      // post, story, reel
    "pinterestBoard": "board-id"           // For Pinterest
  }
}

Response (Immediate Post):

{
  "success": true,
  "postId": "tareno-post-id",
  "platformPostId": "platform-specific-id",
  "status": "published",
  "platform": "instagram"
}

Response (Scheduled Post):

{
  "success": true,
  "postId": "tareno-post-id",
  "status": "scheduled",
  "scheduledAt": "2026-01-15T10:00:00Z",
  "timezone": "Europe/Berlin",
  "platform": "instagram"
}

Upload media to your Tareno library.

Option 1: Upload from URL

{
  "mediaUrl": "https://example.com/image.jpg",
  "fileName": "my-image.jpg"
}

Option 2: Direct Upload

Send as multipart/form-data or binary with headers:

Content-Type: application/octet-stream
X-File-Name: my-video.mp4
X-Content-Type: video/mp4