Publish a New Message

Publish a new Khoros Marketing Messages for the target Initiative

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

Details

Content Object (one of the following)

discriminator: sfEntityType

Image Share

FieldType or value
sfEntityTypeImageShare
captionstring
altTextOptional string for the networks that support alt text for the image

Image Share List

sfEntityTypeImageShareList
imagesarray[object]Each object is an ImageShare as described above.

Video

To publish a video it is mandatory to specify the id of a previously uploaded video asset in the assetIds body field

sfEntityType

Video

videoTitle

string

videoType

Optional enumerated string.

Possible values:

  • REELS to publish instagram reels.

Otherwise don't include it.

descriptionstring
tagsstring. This is a required field. You can add multiple tags and delimit it by comma like tag1, tag2.
categorystring
captionsarray[caption]

YouTube

When YouTube is selected as the service, the value of the category field needs to match one of the keys listed in this table:

KeyDescription
AutosAutos & Vehicles
ComedyComedy
EducationEducation
EntertainmentEntertainment
FilmFilm & Animation
GamesGaming
HowtoHowto & Style
MusicMusic
NewsNews & Politics
NonprofitNonprofits & Activism
PeoplePeople & Blogs
AnimalsPets & Animals
TechScience & Technology
SportsSports
TravelTravel & Events

captions object

sfEntityTypeVideoCaptions
idlong - id an already uploaded captions file
defaultLocaleboolean - optional. Only one can be true if multiple captions are set on the same video to mark them as the default ones. Not all networks support multiple captions.

Status update (a text message with an optional link)

sfEntityTypeStatus
textstring
shareLinkobject

shareLink Object

urlstring
titlestring
descriptionstring
captionstring
thumbnailUrlstring

Carousel

sfEntityTypeCarousel
textstring
imagesarray[object]
shareLinkobject (same as status update)

carousel images Object

titlestring
linkUristring
callToActionobject
callToAction Object
typestring
linkstring
linkCaptionstring
Supported Values for the callToAction Object

The below tables list the User Interface (UI) Field value and its corresponding API value for the callToAction object field.

UI Field ValueCorresponding API Value
Apply NowAPPLY_NOW
Book NowBOOK_TRAVEL
Contact UsCONTACT_US
Donate NowDONATE_NOW
DownloadDOWNLOAD
Get OfferGET_OFFER
Get ShowtimesGET_SHOWTIMES
Learn MoreLEARN_MORE
Listen NowLISTEN_MUSIC
No ButtonNO_BUTTON
Request TimeREQUEST_TIME
Send MessageMESSAGE_PAGE
See MenuSEE_MENU
Shop NowSHOP_NOW
Sign UpSIGN_UP
SubscribeSUBSCRIBE
Watch MoreWATCH_MORE
Path Params
string
required

The initiative you wish to target. Format: int64

Body Params
string

Khoros Marketing internal entity type. Allowed Values: Message

string
string
string
string
Defaults to TWITTER

Social network to publish to. Allowed Values: TWITTER, FACEBOOK, GOOGLEPLUS, SINAWEIBO, LINKEDIN, MULTI_CHANNEL, PINTEREST, YOUTUBE, VK, TIKTOK

targetAccountIds
array of strings
targetAccountIds
string

AllowedValues: VISIBLE, INVISIBLE, VISIBLE_POST_PUBLISH

string
Defaults to DRAFT

Allowed Values: DRAFT, PENDING, AWAITING_APPROVAL, REJECTED, PUBLISHED, ERROR, DELETED, NATIVELY_SCHEDULED

string

Allowed Values: NOT_DELEGATED, SCHEDULED_FOR_DELEGATION, DELEGATION_FAILED, DELEGATED

publicationResults
array of objects
publicationResults
string

Format: date-time

callbacks
array of strings

uniqueItems: true uniqueItems: true Callback URLs need to be a POST type. Other types of URLs may result in an error response.

callbacks
targetingProfile
object
assetIds
array of strings

Array of content center assets ids to include in the message. One asset id of an asset of type video is required when publishing video.

assetIds
string
boolean
sponsor
object

A Sponsor for the Message. Currently, we only support attaching a single sponsor when posting to only Facebook verified Pages (a.k.a. Facebook Branded Content, see https://www.facebook.com/facebookmedia/get-started/branded-content for more info), so any attempt to use it either for other Social Networks or including targets that don’t comply with this rule, will result in an error from the back-end. Note that the Sponsor itself is not restricted to be a verified page, so it could be a regular (non-verified) page or a regular user. As an example, a post could be created, targeting the Facebook verified page of @LeoMessi and that post could be sponsored by @nike.

publisherIds
array of strings
publisherIds
notes
array of objects
notes
Response

Language
Click Try It! to start a request and see the response here! Or choose an example:
text/plain