"Loading..."
Documentation

How to connect the API and Slack

Create an application key and turn on Slack notifications for leaves, claims, and job applications.

Two integrations

Both live in Settings, for people who can manage applications. Applications is an API key your own tools can call. Slack posts a short notice into a channel when something happens in HR. Neither one replaces the product. Mail reply-to name and address are still under Company Settings, Email.

API applications

  1. Settings, then Applications, then New. The form is Create Application.
  2. After it is created, Application Credentials shows APP KEY and APP SECRET. Copy them then. Treat the secret like a password.
  3. Edit opens Update Application if the name or access needs a change.
  4. Regenerate Secret issues a new secret and invalidates the old one. Update every tool that was using it.
  5. Disable turns the key off without deleting it. Enable turns it back on. Delete removes it.

Slack

  1. In Slack, create an incoming webhook for the channel that should receive HR notices. Copy the webhook URL.
  2. In SnapHRM, Settings, then Slack. The screen is Update Slack Setting, under Slack Configurations.
  3. Set it to Enabled (or Disabled when you want it quiet).
  4. Paste the Webhook Endpoint.
  5. Under Channel Notifications, set each event to Yes or No. The list includes Leaves, Expense Claim, and Job Application.
  6. Update.

Yes means that event is posted to the webhook. It does not approve the leave or the claim. Those still happen in leave, expenses, and jobs.

FAQ

Frequently asked questions

Where is the API key?

Settings, then Applications, then New. After you create it, Application Credentials shows APP KEY and APP SECRET. Use Regenerate Secret if you need a new secret. Disable turns an application off without deleting it.

How do I connect Slack?

Settings, then Slack. Set the integration to Enabled, paste the Webhook Endpoint, and choose Yes or No for each channel notification, including Leaves, Expense Claim, and Job Application. Then Update.

Who can open these settings?

Applications and Slack are on the settings menu for people who can manage applications.

Does Slack replace email? +

Have more questions? Browse the documentation or contact us.