# Zulip

> Chat in Zulip: post in channels under topics, send direct messages, read, react to and tidy up messages, and manage your channels. Start a workflow when a message is posted.

App · 14 actions. Web page: https://docs.lodol.com/docs/integrations/zulip

## Actions

### Add reaction

React to a message with an emoji.

**Inputs**

- Message (`message`, text, required): The message's number, from 'Send message' or 'List messages', or its link.
- Emoji (`emoji`, text, required): The emoji's name, such as thumbs_up, check or tada.

**Outputs**

- `emoji` (text): The emoji
- `message_id` (number): The message
- `reacted` (true/false): True

**Example output**

```json
{
  "emoji": "check",
  "message_id": 4312,
  "reacted": true
}
```

### Change message

Change a message's words, or move it to another topic. Zulip allows it for your own messages.

**Inputs**

- Message (`message`, text, required): The message's number, from 'Send message' or 'List messages', or its link.
- Message (`content`, text): The new words. Leave empty to keep them.
- Topic (`topic`, text): A topic to move it to. Leave empty to keep it where it is.

**Outputs**

- `channel` (text): The channel it's in; empty for a direct message
- `content` (text): What it says, in Markdown
- `id` (number): The message's number
- `kind` (text): channel or direct
- `people` (list): For a direct message, everyone in the conversation
- `reactions` (list): The emoji people reacted with
- `sender_email` (text): Their email address
- `sender_id` (number): Their user number
- `sender_name` (text): Who sent it
- `sent_at` (text): When it was sent (ISO 8601)
- `topic` (text): The topic it's under; empty for a direct message

**Example output**

```json
{
  "channel": "engineering",
  "content": "Deploy finished :check:",
  "id": 4312,
  "kind": "channel",
  "people": [],
  "reactions": [
    "check"
  ],
  "sender_email": "lodol-bot@example.zulipchat.com",
  "sender_id": 21,
  "sender_name": "Lodol bot",
  "sent_at": "2026-10-28T09:00:00Z",
  "topic": "deploys"
}
```

### Create or join channel

Make a channel and join it, or join one that already exists.

**Inputs**

- Name (`name`, text, required): The channel's name.
- Description (`description`, text): What it's for, for a new channel.
- Private (`private`, true/false): Make a new channel private, so people join only by invitation. Off by default. Default: `false`.

**Outputs**

- `created_or_joined` (true/false): False if you were already in it
- `id` (number): Its number
- `name` (text): The channel's name
- `private` (true/false): True if it was made private

**Example output**

```json
{
  "created_or_joined": true,
  "id": 12,
  "name": "deploy-alerts",
  "private": false
}
```

### Delete message

Delete a message. Zulip allows it for your own messages, within your organization's time limit.

**Inputs**

- Message (`message`, text, required): The message's number, from 'Send message' or 'List messages', or its link.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (number): The message's number

**Example output**

```json
{
  "deleted": true,
  "id": 4312
}
```

### Get message

Get one message by its number or link.

**Inputs**

- Message (`message`, text, required): The message's number, from 'Send message' or 'List messages', or its link.

**Outputs**

- `channel` (text): The channel it's in; empty for a direct message
- `content` (text): What it says, in Markdown
- `id` (number): The message's number
- `kind` (text): channel or direct
- `people` (list): For a direct message, everyone in the conversation
- `reactions` (list): The emoji people reacted with
- `sender_email` (text): Their email address
- `sender_id` (number): Their user number
- `sender_name` (text): Who sent it
- `sent_at` (text): When it was sent (ISO 8601)
- `topic` (text): The topic it's under; empty for a direct message

**Example output**

```json
{
  "channel": "engineering",
  "content": "Deploy finished :check:",
  "id": 4312,
  "kind": "channel",
  "people": [],
  "reactions": [
    "check"
  ],
  "sender_email": "lodol-bot@example.zulipchat.com",
  "sender_id": 21,
  "sender_name": "Lodol bot",
  "sent_at": "2026-10-28T09:00:00Z",
  "topic": "deploys"
}
```

### Get my account

Get the name and email the connection posts as.

**Inputs**: None.

**Outputs**

- `email` (text): Its email address
- `id` (number): Its user number
- `is_bot` (true/false): True if it's a bot
- `name` (text): Its name

**Example output**

```json
{
  "email": "lodol-bot@example.zulipchat.com",
  "id": 21,
  "is_bot": true,
  "name": "Lodol bot"
}
```

### Leave channel

Leave a channel. A private channel can then be joined again only by invitation.

**Inputs**

- Channel (`channel`, text, required): The channel to leave.

**Outputs**

- `channel` (text): The channel
- `left` (true/false): True once left

**Example output**

```json
{
  "channel": "deploy-alerts",
  "left": true
}
```

### List channels

List the channels you're in.

**Inputs**: None.

**Outputs**

- `channels` (list): Your channels
- `count` (number): How many

**Example output**

```json
{
  "channels": [
    {
      "description": "",
      "id": 7,
      "name": "engineering",
      "private": false
    }
  ],
  "count": 1
}
```

### List messages

List the latest messages, in a channel or topic, from someone, or containing words.

**Inputs**

- Channel (`channel`, text): Only messages in this channel.
- Topic (`topic`, text): With a channel, only messages under this topic.
- Containing (`search`, text): Only messages containing these words.
- From (`sender`, text): Only messages from this person.
- How many (`limit`, number): How many of the latest messages. Defaults to 20. From 1 to 1000.

**Outputs**

- `count` (number): How many
- `messages` (list): The messages, oldest first

**Example output**

```json
{
  "count": 1,
  "messages": [
    {
      "channel": "engineering",
      "content": "Deploy finished :check:",
      "id": 4312,
      "kind": "channel",
      "people": [],
      "reactions": [
        "check"
      ],
      "sender_email": "lodol-bot@example.zulipchat.com",
      "sender_id": 21,
      "sender_name": "Lodol bot",
      "sent_at": "2026-10-28T09:00:00Z",
      "topic": "deploys"
    }
  ]
}
```

### List people

List everyone in the organization who can be messaged, bots included.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `people` (list): The people

**Example output**

```json
{
  "count": 1,
  "people": [
    {
      "email": "sam@example.com",
      "id": 9,
      "is_bot": false,
      "name": "Sam Lee"
    }
  ]
}
```

### List topics

List a channel's topics, most recently active first.

**Inputs**

- Channel (`channel`, text, required): The channel.

**Outputs**

- `channel` (text): The channel
- `count` (number): How many
- `topics` (list): Its topics

**Example output**

```json
{
  "channel": "engineering",
  "count": 1,
  "topics": [
    {
      "latest_message_id": 4312,
      "name": "deploys"
    }
  ]
}
```

### Remove reaction

Take your emoji reaction off a message.

**Inputs**

- Message (`message`, text, required): The message's number, from 'Send message' or 'List messages', or its link.
- Emoji (`emoji`, text, required): The emoji's name, as reacted with.

**Outputs**

- `emoji` (text): The emoji
- `message_id` (number): The message
- `reacted` (true/false): False

**Example output**

```json
{
  "emoji": "check",
  "message_id": 4312,
  "reacted": false
}
```

### Send channel message

Post a message in a channel, under a topic.

**Inputs**

- Channel (`channel`, text, required): The channel to post in.
- Topic (`topic`, text, required): The topic to post under, such as Deploys. A new topic is started if it doesn't exist.
- Message (`content`, text, required): What to say, in Zulip's Markdown.

**Outputs**

- `channel` (text): The channel it was posted in
- `id` (number): The message's number
- `link` (text): A link to it
- `topic` (text): The topic it was posted under

**Example output**

```json
{
  "channel": "engineering",
  "id": 4312,
  "link": "https://example.zulipchat.com/#narrow/near/4312",
  "topic": "deploys"
}
```

### Send direct message

Send a direct message to one person, or a group conversation to a few.

**Inputs**

- To (`people`, list, required): Who to send it to.
- Message (`content`, text, required): What to say, in Zulip's Markdown.

**Outputs**

- `id` (number): The message's number
- `link` (text): A link to it
- `people` (list): Who it was sent to

**Example output**

```json
{
  "id": 4313,
  "link": "https://example.zulipchat.com/#narrow/near/4313",
  "people": [
    "sam@example.com"
  ]
}
```
