API reference

List accounts

List connected profiles and the handles you publish as.

GET/api/v1/accounts

Requires a Bearer API key — see authentication.

Returns the social profiles you've connected — the exact set of platforms ids you can publish to. Networks you haven't connected are omitted.

Request

Send the request to GET /api/v1/accounts. Set your key in the environment as POSTMYISH_KEY to run these as-is.

curl https://postmyish.com/api/v1/accounts \
  -H "Authorization: Bearer $POSTMYISH_KEY"

Response

{
  "data": [
    { "platform": "x", "handle": "@you", "followers": 0, "health": "good" },
    { "platform": "linkedin", "handle": "you", "followers": 0, "health": "good" }
  ]
}

Response fields

dataarray<object>
Connected profiles.
platformstring
The network id.
handlestring
The handle you publish as.
followersinteger
Follower count, where the network reports it.
healthstring
Connection health: good or attention (needs reconnecting).

Try it

Run this endpoint live with your own key. The key is kept in your browser (local storage) and sent straight to the API — nothing passes through the docs.