Create a post

curl -X POST https://social-publish-api.onrender.com/v1/posts \
  -H "x-access-key: $RELAYCAST_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: 4d6e9a8c-launch-2026-11-02" \
  -d '{
    "content": "Our new release is live. Faster uploads, a calendar view and more.",
    "media": [
      { "url": "https://cdn.example.com/release.jpg", "type": "image", "altText": "Release banner" }
    ],
    "targets": [
      { "accountId": "6f1c2a7e-4b8d-4f7a-9a51-2d3c4b5a6e7f" },
      {
        "accountId": "3c8d1e2f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
        "content": "Our new release is live. Here is what our team shipped this quarter and why it matters for your workflow.",
        "options": { "visibility": "PUBLIC" }
      }
    ],
    "scheduledFor": "2026-11-02T15:00:00Z"
  }'

const res = await fetch("https://social-publish-api.onrender.com/v1/posts", {
  method: "POST",
  headers: {
    "x-access-key": process.env.RELAYCAST_API_KEY!,
    "content-type": "application/json",
    "Idempotency-Key": "4d6e9a8c-launch-2026-11-02",
  },
  body: JSON.stringify({
    content: "Our new release is live. Faster uploads, a calendar view and more.",
    media: [{ url: "https://cdn.example.com/release.jpg", type: "image", altText: "Release banner" }],
    targets: [
      { accountId: "6f1c2a7e-4b8d-4f7a-9a51-2d3c4b5a6e7f" },
      {
        accountId: "3c8d1e2f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
        content:
          "Our new release is live. Here is what our team shipped this quarter and why it matters for your workflow.",
        options: { visibility: "PUBLIC" },
      },
    ],
    scheduledFor: "2026-11-02T15:00:00Z",
  }),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const post = body.data; // res.status is 201 (created) or 200 (idempotent replay)

import os, requests

res = requests.post(
    "https://social-publish-api.onrender.com/v1/posts",
    headers={
        "x-access-key": os.environ["RELAYCAST_API_KEY"],
        "Idempotency-Key": "4d6e9a8c-launch-2026-11-02",
    },
    json={
        "content": "Our new release is live. Faster uploads, a calendar view and more.",
        "media": [{"url": "https://cdn.example.com/release.jpg", "type": "image", "altText": "Release banner"}],
        "targets": [
            {"accountId": "6f1c2a7e-4b8d-4f7a-9a51-2d3c4b5a6e7f"},
            {
                "accountId": "3c8d1e2f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
                "content": "Our new release is live. Here is what our team shipped this quarter and why it matters for your workflow.",
                "options": {"visibility": "PUBLIC"},
            },
        ],
        "scheduledFor": "2026-11-02T15:00:00Z",
    },
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
post = body["data"]