Publish a new message.

post https://api.spredfast.com/{environment}/v1/company/{companyId}/initiative/{initiativeId}/message

Publish a new Spredfast Messages for the target Initiative.

Path Params

companyId

int64

required

initiativeId

int64

required

environment

string

required

Body Params

sfEntityType

string

Spredfast internal entity type

string

content

object

title

string

labels

array of strings

labels

service

string

Defaults to TWITTER

Social network to publish to.

targetAccountIds

array of strings

targetAccountIds

organicVisibility

string

status

string

Defaults to DRAFT

delegationStatus

string

publicationResults

array of objects

publicationResults

scheduledPublishDate

date-time

callbacks

array of uris

callbacks

targetingProfile

object

assetIds

array of strings

assetIds

planId

string

nativeScheduling

boolean

Defaults to false

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

Response body

object

sfEntityType

string

Spredfast internal entity type

Message

string

content

object

Has additional fields

title

string

labels

array of strings

labels

service

string

Defaults to TWITTER

Social network to publish to.

TWITTER FACEBOOK GOOGLEPLUS SINAWEIBO LINKEDIN MULTI_CHANNEL PINTEREST YOUTUBE VK

targetAccountIds

array of strings

targetAccountIds

organicVisibility

string

VISIBLE INVISIBLE VISIBLE_POST_PUBLISH

status

string

Defaults to DRAFT

DRAFT PENDING AWAITING_APPROVAL REJECTED PUBLISHED ERROR DELETED NATIVELY_SCHEDULED

delegationStatus

string

NOT_DELEGATED SCHEDULED_FOR_DELEGATION DELEGATION_FAILED DELEGATED

publicationResults

array of objects

publicationResults

object

accountId

string

serviceId

string

serviceLink

string

status

string

PENDING PUBLISHED ERROR DELETED

datePublished

date-time

scheduledPublishDate

date-time

callbacks

array of uris

callbacks

targetingProfile

object

targetingType

string

ENHANCED GATED

targetingValues

object

assetIds

array of strings

assetIds

planId

string

nativeScheduling

boolean

Defaults to false

sponsor

object

profileId

string

The sponsor's profile ID in the corresponding Social Network.

displayName

string

The sponsor's display name in the corresponding Social Network.

link

string

The link to the sponsor's profile in the corresponding Social Network.

publisherIds

array of strings

publisherIds

notes

array of objects

notes

object

sfEntityType

string

Spredfast internal entity type

Note

text

string

The note's text content.

string

The note's ID. This should be left empty or set to 0 for new notes.

createdByDisplayName

string

The formatted name [firstName lastName] of the note's author.

createdByUserId

string

createdDate

date-time

lastModifiedByUserId

string

lastModifiedDate

date-time

Language


xxxxxxxxxx
11
1
curl --request POST \
2
     --url https://api.spredfast.com/environment/v1/company/companyId/initiative/initiativeId/message \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "service": "TWITTER",
8
  "status": "DRAFT",
9
  "nativeScheduling": false
10
}
11
'

Choose an example:

application/json

200OK