UNunified
social
post

Retrieve a post

Changed on

Retrieves a single SocialPost by its id. Obtain id values from the corresponding list endpoint. Use fields to return only the fields you need.

get/social/{connection_id}/post/{id}

Request

Path parameters

connection_idstring required

ID of the connection

idstring required

ID of the Post

Query parameters

fieldsstring[]

Fields to return

rawstring

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

Response

Successful

idstring

Unique identifier for the post

created_atstring date-time

When the post was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

When the post was last updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

profile_idstring

The social profile (page/handle/listing) that owns this post

parent_idstring

The post this one replies to or references

titlestring

Optional post title/headline

bodystring

The main text content of the post

status'DRAFT' | 'SCHEDULED' | 'PUBLISHED' | 'REJECTED' | 'PROCESSING' | 'DELETED' | 'OTHER'

Publication status of the post

type'POST' | 'REPLY' | 'REPOST' | 'QUOTE' | 'EVENT' | 'OFFER' | 'ALERT' | 'STORY' | 'OTHER'

The kind of post

urlstring

Public permalink to the post

languagestring

Language code of the post content

scheduled_atstring date-time

When the post is scheduled to publish (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

rawobject

Raw data from integration

Changes

  • 8897019dff10Revision changes
    • breaking

      removed the enum value parent_post_id from the property items/ of the query request parameter fields

    • warning

      removed the optional property from the response with the status

    • info

      added the enum value parent_id to the property items/ of the query request parameter fields

    • info

      added the optional property to the response with the status

  • 39502239a975Revision changes
    • info

      added the enum value metadata to the property items/ of the query request parameter fields

    • info

      added the optional property to the response with the status