Example — List accounts

curl -X GET https://api.socialdock.com/api/v1/accounts \
  -H "Authorization: Bearer sd_live_xxxx..."

Response

{
  "data": [
    {
      "id": "acc_01hx...",
      "platform": "instagram",
      "username": "@yourbrand",
      "displayName": "Your Brand",
      "connectedAt": "2026-01-15T10:30:00Z"
    }
  ],
  "error": null,
  "meta": { "total": 1 }
}

Example — Publish a post

curl -X POST https://api.socialdock.com/api/v1/instagram/posts/publish \
  -H "Authorization: Bearer sd_live_xxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_01hx...",
    "content": "Hello from SocialDock!",
    "mediaUrls": ["https://example.com/image.jpg"]
  }'

Example — Schedule a post

curl -X POST https://api.socialdock.com/api/v1/linkedin/posts/schedule \
  -H "Authorization: Bearer sd_live_xxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_01hx...",
    "content": "Exciting news coming soon!",
    "scheduledAt": "2026-04-01T09:00:00Z"
  }'

Response

{
  "data": {
    "id": "post_01hy...",
    "platform": "instagram",
    "status": "published",
    "content": "Hello from SocialDock!",
    "publishedAt": "2026-03-16T12:00:00Z",
    "platformPostId": "17854..."
  },
  "error": null,
  "meta": {}
}

Example — Create a draft

curl -X POST https://api.socialdock.com/api/v1/twitter/drafts \
  -H "Authorization: Bearer sd_live_xxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_01hx...",
    "content": "Work in progress — do not publish yet.",
    "mediaUrls": []
  }'

Request body

{
  "url": "https://example.com/photo.jpg"
}

Response

{
  "data": {
    "id": "med_01hz...",
    "url": "https://cdn.socialdock.com/med_01hz.jpg",
    "mimeType": "image/jpeg",
    "sizeBytes": 204800,
    "uploadedAt": "2026-03-16T12:00:00Z"
  },
  "error": null,
  "meta": {}
}

Example — Account analytics

curl -X GET "https://api.socialdock.com/api/v1/instagram/analytics/account?accountId=acc_01hx...&from=2026-03-01&to=2026-03-16" \
  -H "Authorization: Bearer sd_live_xxxx..."

Response

{
  "data": {
    "followers": 12480,
    "followersGrowth": 3.2,
    "impressions": 84200,
    "reach": 61000,
    "engagementRate": 4.7,
    "posts": 18
  },
  "error": null,
  "meta": { "from": "2026-03-01", "to": "2026-03-16" }
}

Example — Reply to a comment

curl -X POST https://api.socialdock.com/api/v1/instagram/comments/reply \
  -H "Authorization: Bearer sd_live_xxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "commentId": "cmt_01ha...",
    "accountId": "acc_01hx...",
    "message": "Thanks for the kind words!"
  }'

Supported events

Register a webhook

curl -X POST https://api.socialdock.com/api/v1/webhooks \
  -H "Authorization: Bearer sd_live_xxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/socialdock",
    "events": ["post_published", "post_failed"],
    "secret": "your_signing_secret"
  }'

Signature verification (HMAC SHA-256)

Every webhook request includes an X-SocialDock-Signature header. Verify it to ensure the payload is authentic.

// Node.js example
const crypto = require("crypto");

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected, "hex"),
    Buffer.from(signature, "hex")
  );
}

// In your Express handler:
app.post("/webhooks/socialdock", (req, res) => {
  const sig = req.headers["x-socialdock-signature"];
  const valid = verifyWebhook(req.rawBody, sig, process.env.WEBHOOK_SECRET);
  if (!valid) return res.status(401).send("Invalid signature");
  // handle event...
  res.sendStatus(200);
});