Etherpad

App · 9 actions

Write together in Etherpad from your workflows: make a pad for each meeting from a template, read its notes to archive or email them, add to it, post in its chat and find pads. Start a workflow when a pad is made, edited or gets a chat message.

Actions

ActionWhat it does
Copy padCopy a pad to a new one, such as a meeting template for each meeting, and get the new pad's link.
Create padMake a pad, such as the notes for a meeting, empty or with text or HTML to start from, and get its link to share.
Delete padDelete a pad, with its history and chat.
Find padsFind pads whose names contain some words or start with a prefix, A to Z or most recently edited first, with their links.
Get chat historyGet the latest messages in a pad's chat, oldest first, with who sent each and when.
Get padGet what a pad says, as plain text and HTML, with who wrote in it, when it was last edited and its links, such as to archive it or email it after a meeting.
Rename padGive a pad a new name, keeping its text, history and chat.
Send chat messagePost a message in a pad's chat, such as a reminder before a meeting or a note that the minutes were sent.
Update padReplace what a pad says with new text or HTML, or add text to the end of it, such as a running log or the actions from a meeting.

Copy pad

Copy a pad to a new one, such as a meeting template for each meeting, and get the new pad's link.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.
New namenew_nametextRequired
The new pad's name: up to 50 characters, without / ? & # $ or :, such as team-meeting-2026-11-07.
Copy history and chatwith_historytrue/false
Copy the pad's history of changes and its chat too. Off, the copy starts fresh with only the text.Default: false.
Replace itoverwritetrue/false
If a pad with the new name is already there, replace it. Off, the step stops instead.Default: false.
Written aswritten_astext
The name Etherpad shows as the author of this change. Defaults to Lodol.

Outputs

copied_fromtext
The name of the pad it was copied from
idtext
The pad's name, which other Etherpad steps take
last_editedtext
When it was last changed (ISO 8601)
linktext
Where the pad opens, to read and edit it
read_only_linktext
A link that shows the pad without letting anyone edit it
revisionsnumber
How many times it has been changed (its latest revision)
Example output
{
  "copied_from": "meeting-template",
  "id": "team-meeting-2026-11-07",
  "last_edited": "2026-11-07T10:42:13Z",
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "read_only_link": "https://pad.example.com/p/r.c9ffa8107c86c659c3c5fdd6719194f5",
  "revisions": 1
}

Create pad

Make a pad, such as the notes for a meeting, empty or with text or HTML to start from, and get its link to share.

Inputs

Pad namepadtextRequired
The new pad's name, which is the end of its link: up to 50 characters, without / ? & # $ or :, such as team-meeting-2026-11-07.
Contentcontenttext
What the pad starts with, such as an agenda. Leave blank for an empty pad.
Formatcontent_formattext
Whether the content is plain text or HTML (with headings, bold, lists and links). Defaults to plain text.One of: text (Plain text), html. Default: text.
If it existsif_existstext
What to do when a pad of that name is already there. Defaults to stopping with an error.One of: error (Stop with an error), keep (Use it as it is). Default: error.
Written aswritten_astext
The name Etherpad shows as the author of this change. Defaults to Lodol.

Outputs

createdtrue/false
Whether the pad was made now (false when it was already there)
idtext
The pad's name, which other Etherpad steps take
last_editedtext
When it was last changed (ISO 8601)
linktext
Where the pad opens, to read and edit it
read_only_linktext
A link that shows the pad without letting anyone edit it
revisionsnumber
How many times it has been changed (its latest revision)
Example output
{
  "created": true,
  "id": "team-meeting-2026-11-07",
  "last_edited": "2026-11-07T10:42:13Z",
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "read_only_link": "https://pad.example.com/p/r.c9ffa8107c86c659c3c5fdd6719194f5",
  "revisions": 1
}

Delete pad

Delete a pad, with its history and chat. It can't be brought back.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.

Outputs

deletedtrue/false
Whether the pad was deleted
idtext
The deleted pad's name
Example output
{
  "deleted": true,
  "id": "team-meeting-2026-11-07"
}

Find pads

Find pads whose names contain some words or start with a prefix, A to Z or most recently edited first, with their links.

Inputs

Name containswordstext
Only pads whose names contain this, such as meeting.
Name starts withstarts_withtext
Only pads whose names start with this, such as team-.
Ordersorttext
Which come first. Sorting by last edit reads up to 500 pads.One of: name (By name, A to Z), edited (Most recently edited first). Default: name.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.

Outputs

countnumber
How many are listed
has_moretrue/false
Whether more pads matched than were listed
padslist
The pads found
totalnumber
How many pads matched in all
Example output
{
  "count": 1,
  "has_more": false,
  "pads": [
    {
      "id": "team-meeting-2026-11-07",
      "last_edited": "2026-11-07T10:42:13Z",
      "link": "https://pad.example.com/p/team-meeting-2026-11-07"
    }
  ],
  "total": 1
}

Get chat history

Get the latest messages in a pad's chat, oldest first, with who sent each and when.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.
How manylimitnumber
The most recent messages to get. Defaults to 25, at most 500.From 1 to 500.

Outputs

countnumber
How many are listed
linktext
Where the pad opens
messageslist
The latest messages, oldest first
pad_idtext
The pad's name
totalnumber
How many messages the pad's chat has in all
Example output
{
  "count": 1,
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "messages": [
    {
      "author_id": "a.KTgqpFEhdqHXOthl",
      "pad_id": "team-meeting-2026-11-07",
      "sender": "Lodol",
      "sent_at": "2026-11-07T10:45:00Z",
      "text": "Notes are ready for review."
    }
  ],
  "pad_id": "team-meeting-2026-11-07",
  "total": 1
}

Get pad

Get what a pad says, as plain text and HTML, with who wrote in it, when it was last edited and its links, such as to archive it or email it after a meeting.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.
Revisionrevisionnumber
Read the pad as it was at this revision (0 is when it was made). Leave blank for what it says now.At least 0.

Outputs

author_countnumber
How many people have written in it
authorslist
Who has written in the pad
htmltext
What the pad says, as HTML with its formatting
idtext
The pad's name, which other Etherpad steps take
last_editedtext
When it was last changed (ISO 8601)
linktext
Where the pad opens, to read and edit it
read_only_linktext
A link that shows the pad without letting anyone edit it
revision_readnumber
Which revision the text and HTML are from
revisionsnumber
How many times it has been changed (its latest revision)
texttext
What the pad says, as plain text
users_onlinenumber
How many people have it open now
Example output
{
  "author_count": 2,
  "authors": [
    {
      "id": "a.KTgqpFEhdqHXOthl",
      "name": "Lodol"
    },
    {
      "id": "a.8Ofh1Pv3XeYzQ2bd",
      "name": "Ada"
    }
  ],
  "html": "<!DOCTYPE HTML><html><body>Team meeting<br><br><ul class=\"bullet\"><li>Budget agreed</li><li>Next meeting on Friday</li></ul><br></body></html>",
  "id": "team-meeting-2026-11-07",
  "last_edited": "2026-11-07T10:42:13Z",
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "read_only_link": "https://pad.example.com/p/r.c9ffa8107c86c659c3c5fdd6719194f5",
  "revision_read": 12,
  "revisions": 12,
  "text": "Team meeting\n\n- Budget agreed\n- Next meeting on Friday\n",
  "users_online": 1
}

Rename pad

Give a pad a new name, keeping its text, history and chat. Its link changes with it, and the old link no longer opens it.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.
New namenew_nametextRequired
The new pad's name: up to 50 characters, without / ? & # $ or :, such as team-meeting-2026-11-07.
Replace itoverwritetrue/false
If a pad with the new name is already there, replace it. Off, the step stops instead.Default: false.

Outputs

idtext
The pad's name, which other Etherpad steps take
last_editedtext
When it was last changed (ISO 8601)
linktext
Where the pad opens, to read and edit it
old_idtext
The pad's name before
read_only_linktext
A link that shows the pad without letting anyone edit it
revisionsnumber
How many times it has been changed (its latest revision)
Example output
{
  "id": "team-meeting-2026-11-07",
  "last_edited": "2026-11-07T10:42:13Z",
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "old_id": "team-meeting",
  "read_only_link": "https://pad.example.com/p/r.c9ffa8107c86c659c3c5fdd6719194f5",
  "revisions": 12
}

Send chat message

Post a message in a pad's chat, such as a reminder before a meeting or a note that the minutes were sent.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.
MessagemessagetextRequired
What to say in the chat.
Sent assendertext
The name the message shows as sent by. Defaults to Lodol.

Outputs

author_idtext
The sender's author ID in Etherpad
linktext
Where the pad opens
pad_idtext
The name of the pad it's in
sendertext
The name it was sent under; empty if they gave none
sent_attext
When it was sent (ISO 8601)
texttext
What the message says
Example output
{
  "author_id": "a.KTgqpFEhdqHXOthl",
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "pad_id": "team-meeting-2026-11-07",
  "sender": "Lodol",
  "sent_at": "2026-11-07T10:45:00Z",
  "text": "Notes are ready for review."
}

Update pad

Replace what a pad says with new text or HTML, or add text to the end of it, such as a running log or the actions from a meeting.

Inputs

PadpadtextRequired
The pad's name, or its link in Etherpad (such as https://pad.example.com/p/team-meeting); a read-only link works too.
ContentcontenttextRequired
The new text, or the text to add to the end.
Replace or addmodetext
Whether the content replaces what the pad says, or is added to the end (plain text only).One of: replace (Replace the text), append (Add to the end). Default: replace.
Formatcontent_formattext
Whether the content is plain text or HTML (with headings, bold, lists and links). Defaults to plain text.One of: text (Plain text), html. Default: text.
Written aswritten_astext
The name Etherpad shows as the author of this change. Defaults to Lodol.

Outputs

idtext
The pad's name, which other Etherpad steps take
last_editedtext
When it was last changed (ISO 8601)
linktext
Where the pad opens, to read and edit it
read_only_linktext
A link that shows the pad without letting anyone edit it
revisionsnumber
How many times it has been changed (its latest revision)
Example output
{
  "id": "team-meeting-2026-11-07",
  "last_edited": "2026-11-07T10:42:13Z",
  "link": "https://pad.example.com/p/team-meeting-2026-11-07",
  "read_only_link": "https://pad.example.com/p/r.c9ffa8107c86c659c3c5fdd6719194f5",
  "revisions": 12
}

On this page