API reference
Every public endpoint, method by method.
API reference
Base URL: https://www.mysocials.in/api/public/v1. All requests need Authorization: Bearer <key>.
Profile & health
| Method | Path | Description |
|---|---|---|
| GET | /me | Authenticated profile |
| GET | /healthz | Liveness check |
| GET | /me/usage | Credit window usage |
| GET | /me/accounts/stats | Per-account aggregates |
| GET | /me/features | Enabled capability flags |
Accounts
| Method | Path | Description |
|---|---|---|
| GET | /accounts | List connected accounts |
| GET | /accounts/{id} | One account |
| DELETE | /accounts/{id} | Disconnect |
Posts
| Method | Path | Description |
|---|---|---|
| GET | /posts | List posts |
| POST | /posts | Create (draft/schedule/publish) |
| GET | /posts/{id} | One post |
| PATCH | /posts/{id} | Edit draft / reschedule |
| DELETE | /posts/{id} | Delete |
| POST | /posts/{id}/publish | Publish now |
| POST | /posts/{id}/approve | Approve pending |
| POST | /posts/{id}/reject | Reject pending |
| POST | /posts/batch | Create many posts |
Media uploads
| Method | Path | Description |
|---|---|---|
| POST | /media | Upload one image, video or PDF |
Send the file as multipart form data in a field named file. The response has a url: pass it in media_urls when you create the post. Media must be uploaded this way first, a link to a file hosted elsewhere is not fetched. An upload that is not attached to a post within 24 hours is deleted. Files over 100 MB are refused with 413: send those as a resumable upload.
Resumable upload (large videos, up to 4 GB)
| Method | Path | Description |
|---|---|---|
| POST | /media/uploads | Start: JSON file_name, mime_type, file_size |
| PUT | /media/uploads/{id}?offset=N | Append the next piece (raw body) |
| GET | /media/uploads/{id} | Bytes received so far |
| POST | /media/uploads/{id}/complete | Finish, returns the url |
Start returns upload_id and chunk_size. Send the file in order, in pieces no larger than chunk_size, each with the offset it starts at. If a piece fails, GET the upload to read its current offset and continue from there. A wrong offset is answered with 409. An upload left untouched for 24 hours is deleted.
For a YouTube video, content is the description. Optional fields on POST /posts: youtube_title (up to 100 characters, defaults to the first line of content), youtube_privacy (public, unlisted or private), youtube_tags, and type: "short_reel" to publish it as a Short.
thumbnail_url gives the video a cover image: upload a JPEG or PNG (up to 2 MB, 1280x720 for a normal video) with POST /media and pass its url. It is shown as the video's cover in MySocials and set as the custom thumbnail on YouTube, which needs a channel that is allowed custom thumbnails. PATCH /posts/{id} accepts thumbnail_url too, until the post is published.
Review before publishing
Add "review": true to POST /posts to hold a post for the account owner instead of leaving a plain draft. It waits at pending_approval: the owner gets a notification, sees it under Pending approval, and approves or rejects it on the post page. Its media is kept while it waits. Approved, it becomes scheduled if it carried a scheduled_at, otherwise a draft whose GET /posts/{id} has approved_at set. Rejected, it is a draft with no approved_at. A deleted post has deleted_at set.
Analytics & content
| Method | Path | Description |
|---|---|---|
| GET | /analytics/summary | Summary metrics |
| GET, POST, DELETE | /evergreen... | Evergreen rules |
| GET, POST, PATCH, DELETE | /syncs... | Sync routes |
Webhooks
Outbound webhooks are a Pro-tier feature: creating one needs a Pro or Agency plan. Managing webhooks you already have (rotate, test, delete) keeps working on any plan with API access. Up to 5 active webhooks per account. See the Webhooks guide for event names and signature verification.
| Method | Path | Description |
|---|---|---|
| GET | /webhooks | List webhooks |
| POST | /webhooks | Create a webhook (Pro-tier) |
| POST | /webhooks/{id}/rotate | Rotate the signing secret |
| POST | /webhooks/{id}/test | Send a synthetic webhook.test event |
| DELETE | /webhooks/{id} | Revoke a webhook |