# Padlet

> Work with your padlets from workflows: add posts, comments and reactions, read a padlet's posts and poll results, make new padlets with Padlet's AI, and start a workflow when someone posts or comments.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/padlet

## Actions

### Add a post

Add a post to a padlet: a subject, some text, a link to attach, a color and a section. Fill in at least one of subject, text and link.

**Inputs**

- Padlet (`board_id`, text, required): Pick one of your padlets, or paste the padlet's link (or its id) for one you were invited to as an admin.
- Subject (`subject`, text): The post's title, up to 500 characters.
- Text (`body`, text): What the post says, up to 10,000 characters.
- Attachment link (`attachment_url`, text): A web address to attach: a page, image, video or file. Padlet shows a preview of it.
- Attachment caption (`attachment_caption`, text): A caption shown with the attachment.
- Color (`color`, text): The post's background color. Leave empty for none. One of: `red`, `orange`, `green`, `blue`, `purple`.
- Section (`section_id`, text): The section to put it in: pick one, or type its title. Leave empty to let Padlet place it.

**Outputs**

- `post` (object): The new post

**Example output**

```json
{
  "post": {
    "attachment_caption": "So close",
    "attachment_url": "https://images.immediate.co.uk/production/volatile/sites/21/2019/03/bike_crash-1468595091943-1jedfc1vp3hut-1000-100-5a5ea67.jpg",
    "author_name": "Bobby Fischer",
    "author_username": "Bobby",
    "body": "The mitochondria is the powerhouse of the cell.",
    "body_html": "The mitochondria is the powerhouse of the cell.",
    "color": "",
    "created_at": "2023-07-22T00:52:32Z",
    "id": "post_lkROZPOe62X2QjMg",
    "padlet_id": "3pbz27udysdf57mg",
    "section_id": "sec_xPdL4geL0PReqpwK",
    "section_title": "Section 1",
    "status": "approved",
    "subject": "Mitochondria",
    "updated_at": "2023-07-22T00:52:32Z",
    "url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234v9qj5snz/wish/1234"
  }
}
```

### Check on an AI padlet

See whether a padlet 'Create a padlet with AI' started is ready, and get it when it is.

**Inputs**

- Reference (`status_key`, text, required): The reference 'Create a padlet with AI' gave back, which starts with ai_recipe_board_.

**Outputs**

- `message` (text): What happened, in a sentence
- `padlet` (object): The new padlet, once it is ready
- `status` (text): success, in_progress or failed
- `status_key` (text): Padlet's reference for this request, for 'Check on an AI padlet'

**Example output**

```json
{
  "message": "The padlet 'Alphabet Adventure for First Graders!' is ready: https://padlet.com/organizationexampleid/alphabet-adventure-uu5qs3r2z3htk7k4",
  "padlet": {
    "created_at": "2025-06-19T00:46:52Z",
    "description": "Let's explore each letter of the alphabet with fun images and words!",
    "id": "uu5qs3r2z3htk7k4",
    "made_by": "mcfrogman",
    "qr_code_url": "https://cdn.padlet.com/padlets/id/qr_code.png",
    "slideshow_url": "https://padlet.com/organizationexampleid/alphabet-adventure-uu5qs3r2z3htk7k4/slideshow",
    "title": "Alphabet Adventure for First Graders!",
    "updated_at": "2025-06-19T00:46:57Z",
    "url": "https://padlet.com/organizationexampleid/alphabet-adventure-uu5qs3r2z3htk7k4"
  },
  "status": "success",
  "status_key": "ai_recipe_board_7e3e243039"
}
```

### Comment on a post

Add a comment to a post, with text, a link to attach, or both.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, which starts with post_, from 'List posts', 'Add a post' or a trigger.
- Comment (`text`, text): What the comment says.
- Attachment link (`attachment_url`, text): A web address of an image or file to attach.

**Outputs**

- `comment` (object): The new comment

**Example output**

```json
{
  "comment": {
    "attachment_url": "https://cdn.padlet.dev/uploads/image.png",
    "author_id": "user_abcd1234efgh5678",
    "created_at": "2025-01-17T12:34:56Z",
    "html": "<p>Great point, thanks for sharing!</p>",
    "id": "comment_1234abcd",
    "post_id": "post_lkROZPOe62X2QjMg",
    "status": "approved",
    "text": "Great point, thanks for sharing!"
  }
}
```

### Create a padlet with AI

Have Padlet's AI make a new padlet from a description, and wait for it (usually under 3 minutes).

**Inputs**

- What to make (`instructions`, text, required): Describe the padlet, up to 2,000 characters: who it is for, the subject and what kind of posts it should have.
- Made for (`role`, text): Who is making it, such as teacher, student or team lead. Padlet uses it to pitch the content. Default: `teacher`.
- Organization (`organization_id`, text): Make it in this team or school, where you are an admin. Leave empty to make it in your own account.

**Outputs**

- `message` (text): What happened, in a sentence
- `padlet` (object): The new padlet, once it is ready
- `status` (text): success, in_progress or failed
- `status_key` (text): Padlet's reference for this request, for 'Check on an AI padlet'

**Example output**

```json
{
  "message": "The padlet 'Alphabet Adventure for First Graders!' is ready: https://padlet.com/organizationexampleid/alphabet-adventure-uu5qs3r2z3htk7k4",
  "padlet": {
    "created_at": "2025-06-19T00:46:52Z",
    "description": "Let's explore each letter of the alphabet with fun images and words!",
    "id": "uu5qs3r2z3htk7k4",
    "made_by": "mcfrogman",
    "qr_code_url": "https://cdn.padlet.com/padlets/id/qr_code.png",
    "slideshow_url": "https://padlet.com/organizationexampleid/alphabet-adventure-uu5qs3r2z3htk7k4/slideshow",
    "title": "Alphabet Adventure for First Graders!",
    "updated_at": "2025-06-19T00:46:57Z",
    "url": "https://padlet.com/organizationexampleid/alphabet-adventure-uu5qs3r2z3htk7k4"
  },
  "status": "success",
  "status_key": "ai_recipe_board_7e3e243039"
}
```

### Get a padlet

Get a padlet's title, description, links and sections, and how many posts and comments it has.

**Inputs**

- Padlet (`board_id`, text, required): Pick one of your padlets, or paste the padlet's link (or its id) for one you were invited to as an admin.

**Outputs**

- `comment_count` (number): How many there are
- `padlet` (object): The padlet
- `post_count` (number): How many there are
- `sections` (list): The padlet's sections, in the padlet's order

**Example output**

```json
{
  "comment_count": 1,
  "padlet": {
    "created_at": "2023-07-27T22:10:09.834Z",
    "description": "Memories of the past",
    "id": "abcd1234efgh5678",
    "made_by": "Jerry Seinfeld",
    "qr_code_url": "https://cdn.padlet.dev/padlets/abcd1234efgh5678/qr_code.png",
    "slideshow_url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234efgh5678/slideshow",
    "title": "My wonderful padlet",
    "updated_at": "2023-07-27T22:10:09.834Z",
    "url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234efgh5678"
  },
  "post_count": 1,
  "sections": [
    {
      "id": "sec_xPdL4geL0PReqpwK",
      "title": "Section 1"
    }
  ]
}
```

### Get a post's attachment

Get what is attached to a post: its preview image and embed code, or a poll's question, answers and votes.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, which starts with post_, from 'List posts', 'Add a post' or a trigger.

**Outputs**

- `attachment` (object): What is attached to the post

**Example output**

```json
{
  "attachment": {
    "embed_code": "",
    "has_poll": true,
    "poll_choices": [
      {
        "text": "Red",
        "votes": 8
      },
      {
        "text": "Blue",
        "votes": 20
      }
    ],
    "poll_closed_at": "2025-09-03T21:48:41.696Z",
    "poll_is_open": true,
    "poll_question": "What's your favorite color?",
    "post_id": "post_lkROZPOe62X2QjMg",
    "preview_image_url": ""
  }
}
```

### Get my account

Get the Padlet account this connection uses, and the teams, schools and classrooms it belongs to.

**Inputs**: None.

**Outputs**

- `account` (object): Your Padlet account
- `organization_count` (number): How many there are
- `organizations` (list): The organizations you belong to

**Example output**

```json
{
  "account": {
    "avatar_url": "https://padlet.net/avatars/ironman.png",
    "bio": "Genius, billionaire, playboy, philanthropist. I am Iron Man.",
    "display_name": "Tony",
    "email": "tony@starkindustries.com",
    "id": "user_abcd1234efgh5678",
    "name": "Tony Stark",
    "username": "ironman"
  },
  "organization_count": 1,
  "organizations": [
    {
      "id": "org_abcd1234efgh5678",
      "name": "Acme Corporation",
      "organization_type": "organization",
      "role": "owner"
    }
  ]
}
```

### List a member's padlets

List the padlets a member of your team, school or classroom has in it, among those you can see.

**Inputs**

- Organization (`organization_id`, text, required): Your Padlet team, school or classroom. You must be one of its admins.
- Member (`member_id`, text, required): The person: pick one, or give their id from 'List organization members'.

**Outputs**

- `count` (number): How many there are
- `member` (object): The member
- `padlets` (list): Their padlets, most recently changed first

**Example output**

```json
{
  "count": 1,
  "member": {
    "display_name": "Tony",
    "email": "tony@starkindustries.com",
    "id": "user_abcd1234efgh5678",
    "name": "Tony Stark",
    "username": "ironman"
  },
  "padlets": [
    {
      "created_at": "2023-07-27T22:10:09.834Z",
      "description": "Memories of the past",
      "id": "abcd1234efgh5678",
      "made_by": "Jerry Seinfeld",
      "qr_code_url": "https://cdn.padlet.dev/padlets/abcd1234efgh5678/qr_code.png",
      "slideshow_url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234efgh5678/slideshow",
      "title": "My wonderful padlet",
      "updated_at": "2023-07-27T22:10:09.834Z",
      "url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234efgh5678"
    }
  ]
}
```

### List my padlets

List the padlets you made, with their links.

**Inputs**: None.

**Outputs**

- `count` (number): How many there are
- `padlets` (list): The padlets, most recently changed first

**Example output**

```json
{
  "count": 1,
  "padlets": [
    {
      "created_at": "2023-07-27T22:10:09.834Z",
      "description": "Memories of the past",
      "id": "abcd1234efgh5678",
      "made_by": "Jerry Seinfeld",
      "qr_code_url": "https://cdn.padlet.dev/padlets/abcd1234efgh5678/qr_code.png",
      "slideshow_url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234efgh5678/slideshow",
      "title": "My wonderful padlet",
      "updated_at": "2023-07-27T22:10:09.834Z",
      "url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234efgh5678"
    }
  ]
}
```

### List organization members

List the people in a Padlet team, school or classroom you are an admin of.

**Inputs**

- Organization (`organization_id`, text, required): Your Padlet team, school or classroom. You must be one of its admins.

**Outputs**

- `count` (number): How many there are
- `members` (list): The members, by name
- `organization` (object): The organization

**Example output**

```json
{
  "count": 1,
  "members": [
    {
      "display_name": "Tony",
      "email": "tony@starkindustries.com",
      "id": "user_abcd1234efgh5678",
      "name": "Tony Stark",
      "username": "ironman"
    }
  ],
  "organization": {
    "id": "org_abcd1234efgh5678",
    "name": "Acme Corporation",
    "organization_type": "organization",
    "role": "owner"
  }
}
```

### List posts

List the posts on a padlet, in the padlet's order, each with its comments. Can be narrowed to one section.

**Inputs**

- Padlet (`board_id`, text, required): Pick one of your padlets, or paste the padlet's link (or its id) for one you were invited to as an admin.
- Section (`section_id`, text): Only posts in this section. Leave empty for all.

**Outputs**

- `count` (number): How many there are
- `padlet_id` (text): The padlet's id
- `posts` (list): The posts, in the padlet's order

**Example output**

```json
{
  "count": 1,
  "padlet_id": "abcd1234efgh5678",
  "posts": [
    {
      "attachment_caption": "So close",
      "attachment_url": "https://images.immediate.co.uk/production/volatile/sites/21/2019/03/bike_crash-1468595091943-1jedfc1vp3hut-1000-100-5a5ea67.jpg",
      "author_name": "Bobby Fischer",
      "author_username": "Bobby",
      "body": "The mitochondria is the powerhouse of the cell.",
      "body_html": "The mitochondria is the powerhouse of the cell.",
      "color": "",
      "comment_count": 1,
      "comments": [
        {
          "attachment_url": "https://cdn.padlet.dev/uploads/image.png",
          "author_id": "user_abcd1234efgh5678",
          "created_at": "2025-01-17T12:34:56Z",
          "html": "<p>Great point, thanks for sharing!</p>",
          "id": "comment_1234abcd",
          "post_id": "post_lkROZPOe62X2QjMg",
          "status": "approved",
          "text": "Great point, thanks for sharing!"
        }
      ],
      "created_at": "2023-07-22T00:52:32Z",
      "id": "post_lkROZPOe62X2QjMg",
      "padlet_id": "3pbz27udysdf57mg",
      "section_id": "sec_xPdL4geL0PReqpwK",
      "section_title": "Section 1",
      "status": "approved",
      "subject": "Mitochondria",
      "updated_at": "2023-07-22T00:52:32Z",
      "url": "https://padlet.dev/api1/my-shiny-padlet-abcd1234v9qj5snz/wish/1234"
    }
  ]
}
```

### React to a post

Like, vote on, star or grade a post. The padlet must have reactions turned on, and you can react to a post only once.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, which starts with post_, from 'List posts', 'Add a post' or a trigger.
- Reaction (`reaction`, text): The kind of reaction. It must be the kind the padlet uses, so the default takes the padlet's own. One of: `padlet_default` (The padlet's own reaction (default)), `like`, `upvote`, `downvote`, `star` (Star rating), `grade`. Default: `padlet_default`.
- Stars or grade (`rating`, number): For a star rating, 0 to 5 stars; for a grade, 0 to 100. With the padlet's own reaction, leave empty for a like, an upvote, one star or a grade of 1. Only when Reaction is The padlet's own reaction (default), Star rating or Grade. From 0 to 100.

**Outputs**

- `reaction` (object): The new reaction

**Example output**

```json
{
  "reaction": {
    "created_at": "2025-07-01T10:30:00.000Z",
    "id": "reaction_abc123def456",
    "padlet_id": "3pbz27udysdf57mg",
    "post_id": "post_lkROZPOe62X2QjMg",
    "reaction_type": "like",
    "value": 1
  }
}
```
