✓ Verified ✍️ Content Creation ✓ Enhanced Data

Repliz

Repliz social media management API integration.

Rating: 4.8 (196 reviews)
Downloads: 1,090 downloads
Version: 1.0.0

Overview

Repliz social media management API integration.

Complete Documentation

View Source →

Repliz API Skill

Prerequisites & Setup

Before using this skill, you must complete the following setup steps:

1. Register/Login to Repliz

Register: Visit https://repliz.com/register to create a new account
Login: Visit https://repliz.com/login to sign in to your existing account

2. Connect Social Media Accounts

After logging in, connect your social media accounts:

Go to your Repliz dashboard
Add and connect accounts like Instagram, Threads, TikTok, Facebook, LinkedIn, or YouTube
Ensure the accounts show as "connected" before proceeding

3. Obtain API Credentials

To get your Access Key and Secret Key for Basic Authentication:

Navigate to https://repliz.com/user/setting/api
Generate or copy your Access Key and Secret Key
Store these credentials securely - they grant access to post, delete, and manage your social media content

4. Configure Environment Variables

This skill requires the following environment variables to be set:

bash

export REPLIZ_ACCESS_KEY="your-access-key-here"
export REPLIZ_SECRET_KEY="your-secret-key-here"

## Authentication

All API requests require **Basic Authentication** in the header:
- **Username**: $REPLIZ_ACCESS_KEY
- **Password**: $REPLIZ_SECRET_KEY
- **Base URL**: `https://api.repliz.com`

## API Endpoints

### Accounts

**GET /public/account**
- Query params: `page` (default 1), `limit` (default 10), `search` (optional)
- Returns list of connected social media accounts
- Fields: `_id`, `generatedId`, `name`, `username`, `picture`, `isConnected`, `type` (instagram/threads/tiktok/etc), `userId`, `createdAt`, `updatedAt`

**GET /public/account/{_id}**
- Get account details by ID (use `_id` field from account list)
- Returns full account info including `token.access` for posting

---

### Schedules

**GET /public/schedule**
- Query params: `page`, `limit`, `accountIds` (can be repeated)
- Returns scheduled posts

**GET /public/schedule/{_id}**
- Get schedule details by ID

**POST /public/schedule**
- Create new scheduled post. Request body varies by type:

Text post (Facebook, Threads):

json { "title": "", "description": "Your post text", "type": "text", "medias": [], "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e" }

text

Image post (Facebook, Instagram, Threads, TikTok, LinkedIn):

json { "title": "", "description": "Caption", "type": "image", "medias": [{"type": "image", "thumbnail": "url", "url": "url", "alt": "description"}], "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e" }

text

Video post (Facebook, Instagram, Threads, TikTok, YouTube, LinkedIn):

json { "title": "Hello there, this is from Repliz", "description": "Hello there, this is from Repliz", "type": "video", "medias": [ { "type": "video", "thumbnail": "thumbnail-url", "url": "video-url" } ], "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e" }

text

Album post (Facebook, Instagram, Threads, TikTok, LinkedIn):

json { "title": "Hello there, this is from Repliz", "description": "Hello there, this is from Repliz", "type": "album", "medias": [ { "type": "image", "thumbnail": "thumbnail-url-1", "url": "image-url-1", "alt": "alt-image-1" }, { "type": "image", "thumbnail": "thumbnail-url-2", "url": "image-url-2", "alt": "alt-image-2" }, { "type": "image", "thumbnail": "thumbnail-url-99", "url": "image-url-99", "alt": "alt-image-99" }, ], "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e" }

text

Story post (Facebook, Instagram):

json { "title": "", "description": "", "type": "story", "medias": [ { "type": "image or video", // you can choose "thumbnail": "thumbnail-url", "url": "media-url" } ], "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e" }

text

Instagram post with additional info:

json { "title": "Hello there, this is from Repliz", "description": "Hello there, this is from Repliz", "type": "video", "medias": [ { "type": "video", "thumbnail": "thumbnail-url", "url": "video-url" } ], "additionalInfo": { "collaborators": [ "usernameCollab1", "usernameCollab2", "usernameCollab3" ] }, "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e" }

text

Nested/Thread post (Threads):

json { "title": "", "description": "First Post", "type": "text", "medias": [], "scheduleAt": "2026-02-14T10:35:09.658Z", "accountId": "680affa5ce12f2f72916f67e", "replies": [ {"title": "", "description": "Second Post reply First Post", "type": "text", "medias": []}, {"title": "", "description": "Third Post reply Second Post", "type": "text", "medias": []} ] }

text

**DELETE /public/schedule/{_id}**
- Delete scheduled post (cannot be recovered)

---

### Comment Queue

**GET /public/queue**
- Query params: `page`, `limit`, `search`, `status` (pending/resolved/ignored), `accountIds` (can be repeated)
- Returns comment queue from social media

**GET /public/queue/{_id}**
- Get queue item details

**POST /public/queue/{_id}**
- Reply to comment (automatically marks as resolved)

json { "text": "Your reply" } ``


Error Handling

401: Invalid authorization header

404: Not found

500: Internal server error


Notes

accountId for posting comes from _id field in account list

scheduleAt uses ISO 8601 format with timezone (e.g., 2026-02-14T10:35:09.658Z`)
Queue status can be: pending, resolved, ignored

Installation

Terminal bash


openclaw install repliz

Copied!

💻Code Examples

Text post (Facebook, Threads):

text-post-facebook-threads.json

{
  "title": "",
  "description": "Your post text",
  "type": "text",
  "medias": [],
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e"
}

Image post (Facebook, Instagram, Threads, TikTok, LinkedIn):

image-post-facebook-instagram-threads-tiktok-linkedin.json

{
  "title": "",
  "description": "Caption",
  "type": "image",
  "medias": [{"type": "image", "thumbnail": "url", "url": "url", "alt": "description"}],
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e"
}

Video post (Facebook, Instagram, Threads, TikTok, YouTube, LinkedIn):

video-post-facebook-instagram-threads-tiktok-youtube-linkedin.json

{
  "title": "Hello there, this is from Repliz",
  "description": "Hello there, this is from Repliz",
  "type": "video",
  "medias": [
    {
      "type": "video",
      "thumbnail": "thumbnail-url",
      "url": "video-url"
    }
  ],
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e"
}

Album post (Facebook, Instagram, Threads, TikTok, LinkedIn):

album-post-facebook-instagram-threads-tiktok-linkedin.json

{
  "title": "Hello there, this is from Repliz",
  "description": "Hello there, this is from Repliz",
  "type": "album",
  "medias": [
    {
      "type": "image",
      "thumbnail": "thumbnail-url-1",
      "url": "image-url-1",
      "alt": "alt-image-1"
    },
    {
      "type": "image",
      "thumbnail": "thumbnail-url-2",
      "url": "image-url-2",
      "alt": "alt-image-2"
    },
    {
      "type": "image",
      "thumbnail": "thumbnail-url-99",
      "url": "image-url-99",
      "alt": "alt-image-99"
    },
  ],
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e"
}

Story post (Facebook, Instagram):

story-post-facebook-instagram.json

{
  "title": "",
  "description": "",
  "type": "story",
  "medias": [
    {
      "type": "image or video", // you can choose
      "thumbnail": "thumbnail-url",
      "url": "media-url"
    }
  ],
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e"
}

Instagram post with additional info:

instagram-post-with-additional-info.json

{
  "title": "Hello there, this is from Repliz",
  "description": "Hello there, this is from Repliz",
  "type": "video",
  "medias": [
    {
      "type": "video",
      "thumbnail": "thumbnail-url",
      "url": "video-url"
    }
  ],
  "additionalInfo": {
    "collaborators": [
      "usernameCollab1",
      "usernameCollab2",
      "usernameCollab3"
    ]
  },
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e"
}

Nested/Thread post (Threads):

nestedthread-post-threads.json

{
  "title": "",
  "description": "First Post",
  "type": "text",
  "medias": [],
  "scheduleAt": "2026-02-14T10:35:09.658Z",
  "accountId": "680affa5ce12f2f72916f67e",
  "replies": [
    {"title": "", "description": "Second Post reply First Post", "type": "text", "medias": []},
    {"title": "", "description": "Third Post reply Second Post", "type": "text", "medias": []}
  ]
}

- Reply to comment (automatically marks as resolved)

--reply-to-comment-automatically-marks-as-resolved.json

{
  "text": "Your reply"
}

example.sh

export REPLIZ_ACCESS_KEY="your-access-key-here"
export REPLIZ_SECRET_KEY="your-secret-key-here"

## Authentication

All API requests require **Basic Authentication** in the header:
- **Username**: $REPLIZ_ACCESS_KEY
- **Password**: $REPLIZ_SECRET_KEY
- **Base URL**: `https://api.repliz.com`

## API Endpoints

### Accounts

**GET /public/account**
- Query params: `page` (default 1), `limit` (default 10), `search` (optional)
- Returns list of connected social media accounts
- Fields: `_id`, `generatedId`, `name`, `username`, `picture`, `isConnected`, `type` (instagram/threads/tiktok/etc), `userId`, `createdAt`, `updatedAt`

**GET /public/account/{_id}**
- Get account details by ID (use `_id` field from account list)
- Returns full account info including `token.access` for posting

---

### Schedules

**GET /public/schedule**
- Query params: `page`, `limit`, `accountIds` (can be repeated)
- Returns scheduled posts

**GET /public/schedule/{_id}**
- Get schedule details by ID

**POST /public/schedule**
- Create new scheduled post. Request body varies by type:

Text post (Facebook, Threads):

example.txt

**DELETE /public/schedule/{_id}**
- Delete scheduled post (cannot be recovered)

---

### Comment Queue

**GET /public/queue**
- Query params: `page`, `limit`, `search`, `status` (pending/resolved/ignored), `accountIds` (can be repeated)
- Returns comment queue from social media

**GET /public/queue/{_id}**
- Get queue item details

**POST /public/queue/{_id}**
- Reply to comment (automatically marks as resolved)