Create a post

Request

Method: POST
URL: https://app.socialk.it/core/api/<workspaceUuid>/posts
Authorization: Bearer <token>

Body

{
  "date": "2024-05-23",
  "time": "15:00",
  "timezone": "Europe/Paris",
  "schedule": true,
  "schedule_now": true,
  "queue": true,
  "accounts": [1,2,3],
  "tags": [1,2],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "This is the content",
          "media": [
            1
          ]
        }
      ],
      "options": {
        "mastodon": {
          "sensitive": false
        }
      }
    }
  ]
}

Key	Format	Required	Description
date	Y-m-d
time	H:i
timezone	Europe/Paris		Specify your preferred time zone when necessary. In its absence, SocialKit will default to the timezone set for your account.
schedule	boolean		Set to `true` to schedule the post. Set to `false` to create the post without scheduling.
schedule_now	boolean
queue	boolean		Set to `true` to add the post to the queue.
accounts	array		Array of account IDs
accounts.*	integer	required	Account ID
tags	array		Array of tag IDs
tags.*	integer	required	Tag ID
`versions`	array	required	Array of version objects
`versions.*.account_id`	integer	required	Specify the account for which the version is available. For the original version, use the value `0`.
`versions.*.is_original`	boolean	required	The first version is always set to `true`.
`versions.*.content`	array	required	Array of content objects
`versions..content..body`	null	string
`versions..content..url`	null	string
`versions..content..media`	array		Array of media IDs
`versions..content..media.*`	integer	required	Media ID
`versions..content..video_thumbs`	array		Array of media relationship objects for video ID and its thumbnail ID
`versions..content..video_thumbs.*`	object		Media relationship object for video ID and its thumbnail ID
`versions..content..video_thumbs.*.media_id`	integer		Existing video media ID (only supported video mime types)
`versions..content..video_thumbs.*.thumb_id`	integer		Existing image media ID (only supported image mime types)
`versions.*.options`	object		Options available for each social service provider:

{
  "facebook_page": {
    "type": "post" // post,reel,story
  },
  "instagram": {
    "type": "post" // post,reel,story
  },
  "linkedin": {
    "visibility": "PUBLIC" // PUBLIC,CONNECTIONS
  },
  "mastodon": {
    "sensitive": false // boolean
  },
  "pinterest": {
    "link": null, // null|string
    "title": "", // string
    "boards": {
      "account-1": "671472010431333260" // string | The key `account-*` is the ID of your Pinterest account
    }
  },
  "youtube": {
    "title": null', // null|string
    "status": "public" // public,private,unlisted
  },
  "gbp": { // Google Business Profile
    "type": "post", // post,offer,event
    "button": "NONE", // NONE,BOOK,ORDER,SHOP,LEARN_MORE,SIGN_UP,CALL
    "button_link": "", // string | Leave empty if button is `NONE` or `CALL`
    "offer_has_details": false, // boolean | Only applies if type is `offer`
    "coupon_code": "", // string | Only applies if type is `offer` and `offer_has_details` is true
    "offer_link": "", // string | Only applies if type is `offer` and `offer_has_details` is true
    "terms": "", // string | Only applies if type is `offer` and `offer_has_details` is true
    "event_title": "", // string | Only applies if type is `event` or `offer`
    "start_date": null, // null|string | Only applies if type is `event` or `offer` 
    "end_date": null, // null|string | Only applies if type is `event` or `offer`
    "event_has_time": false, // boolean | Only applies if type is `event`
    "start_time": "09:00", // string | Only applies if type is `event` and `event_has_time` is true
    "end_time": "17:00" // string | Only applies if type is `event` and `event_has_time` is true
  },
  "tiktok": {
    "privacy_level": {
      "account-2": 'PUBLIC_TO_EVERYONE' // string | PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDS,SELF_ONLY | The key `account-*` is the ID of your TikTok account. 
    },
    "allow_comments": {
      "account-2": true // boolean | The key `account-*` is the ID of your TikTok account
    },
    "allow_duet": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "allow_stitch": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "content_disclosure": {
       "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "brand_organic_toggle": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "brand_content_toggle": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
  }
}

Response:

{
  "id": 3,
  "uuid": "6059e1b3-e102-4be5-951b-82698abd9ee3",
  "name": "Motivation",
  "hex_color": "#000000"
}

Request

Body

On this page