Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Firstwork integrates with Slack to send notifications, alerts, and updates to your team’s channels. Keep your hiring team informed in real-time about application updates, compliance results, and workflow events.

​
Setup

1

Create a Slack app

  1. Visit the Slack API portal
  2. Create a new app for your workspace
  3. Configure the required permissions (chat:write, channels:read)
2

Install to workspace

Install the Slack app to your workspace and authorize the required permissions.
3

Configure in Firstwork

Add the Slack Bot Token to your Firstwork company settings under Settings > Integrations > Slack.

​
Slack Message Action

The Slack Message action in automations:
ConfigurationDescription
ChannelTarget Slack channel
MessageMessage content with formatting
VariablesObject Graph variables for dynamic content

​
Message Formatting

Slack messages support rich formatting: 
*New Application Received*

Candidate: {{application.candidate.first_name}} {{application.candidate.last_name}}
Hiring Flow: {{application.hiring_flow.name}}
Stage: {{application.current_stage.name}}
Applied: {{application.created_at}}

​
Common Use Cases

Use CaseTriggerChannel
New applicationApplication created#hiring-feed
Stage changeApplication advanced#hiring-updates
Compliance failureRule evaluation failed#compliance-alerts
Document uploadedDocument submitted#document-review
Interview scheduledBooking confirmed#interview-schedule
Offer acceptedApplication completed#offers
Automation failureAction execution failed#ops-alerts

​
Best Practices

  • Use dedicated channels for different notification types to avoid noise
  • Include relevant links in messages so team members can take action quickly
  • Set up rules to only notify on important events, not every minor change
  • Use thread replies for related updates to keep channels organized