Repliz social media management API integration. Use when working with Repliz to manage social media accounts, schedules, and comments. Requires REPLIZ_ACCESS...
---
name: repliz
description: Repliz social media management API integration. Use when working with Repliz to manage social media accounts, schedules, and comments. Requires REPLIZ_ACCESS_KEY and REPLIZ_SECRET_KEY environment variables.
homepage: https://repliz.com
metadata: {"clawdbot":{"emoji":"📱","requires":{"bins":["curl"],"env":["REPLIZ_ACCESS_KEY","REPLIZ_SECRET_KEY"]},"primaryEnv":"REPLIZ_ACCESS_KEY"}}
---
# 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:
1. Navigate to https://repliz.com/user/setting/api
2. Generate or copy your **Access Key** and **Secret Key**
3. 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"
}
```
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):
```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):
```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):
```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:
```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):
```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": []}
]
}
```
**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
don't have the plugin yet? install it then click "run inline in claude" again.