Creates a new post on a board. Returns a post object.

๐Ÿ“˜

API key

You will need to include your API key found here.

Please include the key in your header. {"X-API-KEY": <api_key>}

An example of a basic request body is displayed below. It follows the JSON:API specification.

{
  "data": {
    "type": "post",
    "attributes": {
      "content": {
        "subject": "Test post",
        "body": "Created using the API!",
        "attachment": {
          "url": "http://example.com",
          "caption": "Example website"
        }
      },
      "color": "red"
    },
    "relationships": {
      "section": {
        "data": {
          "id": "abcd1234efgh5678"
        }
      }
    }
  }
}

Body parameters

* required

**affects posts in certain formats

PropertiesTypeDescription
type**stringType should be set to post.
attributes.content*objectContent object holding subject, body and attachment information.

content.subject denotes the subject of the post.

content.body denotes the body of the post.

content.attachment is the attachment object of the post. Currently only supports url links.

One of subject, body or attachment is required to make a successful post request.
attributes.colorstringColor of the post.

Allowed values are red,orange,green,blue,purple.
attributes.manualSortPositionobject

previousPostId:string
Sets the position of the post relative to the post that comes before it.

previousPostId denotes the post that is on top or to the left of the post you are creating.
attributes.mapProps**object

latitude:float
longitude:float
locationName:string
Map properties of a post. Only affects posts in boards of map format.

mapProps.latitude denotes the latitude of the post in Padlet map format.

mapProps.longitude denotes the longitude of the post in Padlet map format.

mapProps.locationName denotes the custom location name.

Both latitude and longitude must be present to use mapProps.
attributes.canvasProps**object

left:int
right:int
width:int
Canvas property of a post. Only affects posts in boards of canvas format.

canvasProps.left denotes the left position of the post in Padlet canvas format.

canvasProps.top denotes the top position of the post in Padlet canvas format.

canvasProps.width denotes the width of the post.

All 3 are needed to use canvasProps
relationships.sectionstringThe section which the post belongs to.

section.data.id must belong to the wall. You can get this information via our get board by id call with include=sections query params.
Language
Authorization
Header
Click Try It! to start a request and see the response here!