Get a social post

GEThttps://api.norreach.app/v1/social/posts/{id}

One social post with its version per network: the text, the media addresses, whether each network's copy is pending, publishing, published or failed (with a plain sentence when it failed), and when it is scheduled.

social:readOperation id: get_social_post

GET/social/posts/{id}

curl -X GET "https://api.norreach.app/v1/social/posts/{id}" \
  -H "Authorization: Bearer $NORREACH_API_KEY"

Get a social post

{
  "id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
  "object": "social_post",
  "title": "Winter staffing",
  "status": "scheduled",
  "scheduled_at": "2026-11-12T08:30:00.000Z",
  "timezone": "Europe/Stockholm",
  "labels": [
    "winter"
  ],
  "notes": "",
  "networks": [
    "linkedin",
    "instagram"
  ],
  "variants": [
    {
      "network": "linkedin",
      "network_name": "LinkedIn",
      "content": "Clinics plan their winter staffing now. We place licensed nurses within 48 hours.",
      "media_urls": [],
      "status": "pending",
      "published_at": null,
      "problem": null
    },
    {
      "network": "instagram",
      "network_name": "Instagram",
      "content": "Winter is coming — so are our nurses.",
      "media_urls": [
        "https://media.example.com/social-media/6a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d/2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f.jpg"
      ],
      "status": "pending",
      "published_at": null,
      "problem": null
    }
  ],
  "created_at": "2026-11-05T09:12:33.120Z",
  "updated_at": "2026-11-05T09:20:01.000Z"
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope social:read. API keys and scopes

Path parameters

idstring (uuid)pathrequired

An id (UUID).

Response

200application/json— Get a social post

idstring (uuid)required

An id (UUID).

object"social_post"required

titlestringrequired

The post's name in the calendar (never published).

statusenumrequired

idea, draft, in_review, scheduled, publishing, published or failed.

One of:ideadraftin_reviewscheduledpublishingpublishedfailed

scheduled_atstring | nullrequired

When it goes out (scheduled posts).

timezonestring | nullrequired

The IANA time zone it was scheduled in, for display.

labelsstring[]required

notesstringrequired

Internal notes (never published).

networksenum[]required

variantsobject[]required

Show child attributes

variants[].networkenumrequired

linkedin, x, instagram, facebook or tiktok.

One of:linkedinxinstagramfacebooktiktok

variants[].network_namestringrequired

variants[].contentstringrequired

The text for this network.

variants[].media_urlsstring[]required

Pictures and videos, in order (public https addresses).

variants[].statusenumrequired

pending (not sent yet), publishing, published or failed.

One of:pendingpublishingpublishedfailed

variants[].published_atstring | nullrequired

variants[].problemstring | nullrequired

When this network's publish failed: a plain sentence (the details are in the app).

created_atstringrequired

RFC 3339 UTC timestamp with milliseconds.

updated_atstringrequired

RFC 3339 UTC timestamp with milliseconds.

Errors

Errors are application/problem+json with a stable code.

Status	Code	Meaning
400	`bad_request`	The request couldn't be read.
400	`unknown_field`	The request has a field this operation doesn't know.
401	`unauthorized`	A valid API key is required.
403	`insufficient_scope`	This API key doesn't have the scope this operation needs.
403	`feature_not_enabled`	The API isn't switched on for this workspace.
404	`not_found`	That doesn't exist.
429	`rate_limited`	Too many requests. Slow down and try again.
500	`server_error`	Something went wrong on our side.
503	`unavailable`	The API isn't available right now. Try again shortly.

GET/social/posts/{id}

curl -X GET "https://api.norreach.app/v1/social/posts/{id}" \
  -H "Authorization: Bearer $NORREACH_API_KEY"

Get a social post

{
  "id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
  "object": "social_post",
  "title": "Winter staffing",
  "status": "scheduled",
  "scheduled_at": "2026-11-12T08:30:00.000Z",
  "timezone": "Europe/Stockholm",
  "labels": [
    "winter"
  ],
  "notes": "",
  "networks": [
    "linkedin",
    "instagram"
  ],
  "variants": [
    {
      "network": "linkedin",
      "network_name": "LinkedIn",
      "content": "Clinics plan their winter staffing now. We place licensed nurses within 48 hours.",
      "media_urls": [],
      "status": "pending",
      "published_at": null,
      "problem": null
    },
    {
      "network": "instagram",
      "network_name": "Instagram",
      "content": "Winter is coming — so are our nurses.",
      "media_urls": [
        "https://media.example.com/social-media/6a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d/2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f.jpg"
      ],
      "status": "pending",
      "published_at": null,
      "problem": null
    }
  ],
  "created_at": "2026-11-05T09:12:33.120Z",
  "updated_at": "2026-11-05T09:20:01.000Z"
}