Install FullForms for Slack

What it does

Once installed and configured:

• /fullforms <query> searches the lists you've added to the channel and replies with matching entries plus deep links to the web app.
• /fullforms add [entry] returns one button per list added to the channel. Click through to fill out the new entry on the web (text pre-filled if you supplied one).
• /fullforms lists shows which lists this channel can search.
• /fullforms help prints the command reference.

All responses are ephemeral, so the slash command never adds noise to the channel for other members.

Before you start

You'll need:

1. A FullForms account at list.fullforms.com.
2. A team workspace on that account. Personal workspaces don't connect to Slack. Create one from your account page if you don't have one yet.
3. Owner or admin role on that team workspace.
4. Owner or admin role on the Slack workspace where you're installing the app, since Slack restricts who can authorize new bots.

Install steps

1. Sign in at list.fullforms.com and switch to the team workspace you want to connect.
2. Open Workspace settings from the sidebar switcher.
3. Scroll to the Slack section and click Connect to Slack.
4. Slack will ask you to pick a workspace and approve the install. Click Allow.
5. You'll land back on the Workspace settings page with a "Connected" badge and your Slack workspace name.

Add channels to your lists

A channel only sees entries from the lists that have been added to it. You add from each list's settings page:

1. Open a list, click the gear icon to open its Settings page.
2. Scroll to Slack channels.
3. Click Add next to each channel that should be able to find this list with /fullforms.

Repeat for any other lists you want surfaced in Slack. The same list can be added to multiple channels, and the same channel can carry multiple lists.

Try it

In a bound channel, type:

/fullforms ftl
/fullforms add new term
/fullforms lists
/fullforms help

Only you will see the response (Slack ephemeral messages are single-recipient).

What the bot can do, and can't

The integration uses these Slack scopes:

• commands to handle slash commands.
• channels:read, groups:read to list the channels you might bind.
• users:read and users:read.email reserved for a future inline add modal (not used today). Slack requires both to be granted together.

The bot does not:

• Read message content. Slash command payloads only carry the text you typed after /fullforms, never other channel messages.
• Post into channels on its own. Confirmations come back as ephemeral responses tied to your specific command invocation.
• Access DMs or private conversations except through the slash command.

Disconnecting

From Workspace settings → Slack, click Disconnect. The integration is soft-uninstalled (kept for audit), and your channel configuration carries over automatically if you reconnect to the same Slack team later.

To remove a single channel without disconnecting altogether, visit the relevant list's settings page and click the Added chip to toggle it off.

Troubleshooting

"No lists have been added to this channel yet."

The channel you ran the command in hasn't been added to any list yet. Open a list's settings, scroll to Slack channels, and add the channel.

"This Slack workspace isn't connected to a List team workspace."

The Slack team you installed in isn't connected to a List team workspace, or the connection was disconnected. Reconnect from Workspace settings → Slack.

Slash command not appearing

Slack caches slash command definitions briefly. If /fullforms doesn't autocomplete after a fresh install, give it a minute or restart the Slack client.

OAuth fails with "Invalid permissions requested."

This is usually stale consent state. Disconnect from Workspace settings, then click Connect to Slack again. The fresh install resolves it.

Need more help?

Email [email protected] with your List team workspace name and a description of what you're seeing.