MySocials

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

MethodPathDescription
GET/meAuthenticated profile
GET/healthzLiveness check
GET/me/usageCredit window usage
GET/me/accounts/statsPer-account aggregates
GET/me/featuresEnabled capability flags

Accounts

MethodPathDescription
GET/accountsList connected accounts
GET/accounts/{id}One account
DELETE/accounts/{id}Disconnect

Posts

MethodPathDescription
GET/postsList posts
POST/postsCreate (draft/schedule/publish)
GET/posts/{id}One post
PATCH/posts/{id}Edit draft / reschedule
DELETE/posts/{id}Delete
POST/posts/{id}/publishPublish now
POST/posts/{id}/approveApprove pending
POST/posts/{id}/rejectReject pending
POST/posts/batchCreate many posts

Media uploads

MethodPathDescription
POST/mediaUpload 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)

MethodPathDescription
POST/media/uploadsStart: JSON file_name, mime_type, file_size
PUT/media/uploads/{id}?offset=NAppend the next piece (raw body)
GET/media/uploads/{id}Bytes received so far
POST/media/uploads/{id}/completeFinish, 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

MethodPathDescription
GET/analytics/summarySummary 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.

MethodPathDescription
GET/webhooksList webhooks
POST/webhooksCreate a webhook (Pro-tier)
POST/webhooks/{id}/rotateRotate the signing secret
POST/webhooks/{id}/testSend a synthetic webhook.test event
DELETE/webhooks/{id}Revoke a webhook