define.wtf
Integrations

Integrations Overview

Connect define.wtf to Slack, your identity provider, and automation tools

Integrations

define.wtf integrates with popular team communication, identity management, and automation platforms. This allows you to bring acronym lookup into your daily workflow, sync team identity automatically, and build custom workflows.

Integration Types

Communication Integrations

Slack

Bring define.wtf into Slack with the /define slash command. Team members can look up definitions without leaving Slack, and admins can manage workspace connection through a simple OAuth flow.

Read: Slack Integration

Key Features:

  • /define TERM command for instant lookups
  • Block Kit formatted responses with links to full definitions
  • No app account required for Slack users
  • One-click OAuth setup

Identity & Authentication

Single Sign-On (SSO)

Enable your team to log in with company credentials using OpenID Connect (OIDC) via Auth0. Supports Okta, Azure AD, Google Workspace, OneLogin, and more.

Read: SSO Configuration

Key Features:

  • Self-service setup wizard
  • Automatic first-time user creation
  • Optional group-based role mapping
  • Multi-provider support (advanced)
  • Compliance audit trails

SCIM 2.0 Provisioning

Automatically provision users from your identity provider. New team members are created in define.wtf when added to your IdP, and removed when deprovisioned.

Read: SCIM 2.0 Provisioning

Key Features:

  • Auto-create users from Okta, Azure AD, OneLogin
  • Sync user attributes (name, email, groups)
  • Automatic deprovisioning
  • Enterprise-grade security with API tokens
  • Full SCIM 2.0 compliance

Automation & Custom Workflows

Webhooks

Subscribe to define.wtf events (definitions created, edited, deleted, etc.) and send real-time notifications to external systems. Build custom automations, dashboards, and integrations.

Read: Webhooks & Automations

Key Features:

  • Real-time event notifications
  • Fire-and-forget delivery with retry logic
  • JSON payloads with full event context
  • Webhooks for all mutations (create, update, delete)
  • Perfect for Zapier, integromat, and custom automation

Common Integration Scenarios

Scenario 1: Team Communication + Lookup

Tools: Slack

Set up Slack integration so your team can use /define TERM in Slack channels. No separate logins or app accounts needed.

Setup time: 5 minutes

See: Slack Integration

Scenario 2: Enterprise SSO + Auto-Provisioning

Tools: SSO + SCIM

Your team logs in with company credentials. New team members are automatically created when added to your IdP. Zero manual user management.

Setup time: 20-30 minutes (depending on IdP)

See: SSO + SCIM

Scenario 3: Custom Slack Bot

Tools: Webhooks + Slack App

Build a custom Slack bot that watches for new definitions in define.wtf and posts summaries to a #announcements channel. Or send weekly "new acronyms" digests.

Setup time: 1-2 hours (development)

See: Webhooks & Automations

Scenario 4: Activity Monitoring Dashboard

Tools: Webhooks + Spreadsheet or BI Tool

Send all define.wtf activity to a webhook, forward to Zapier or Make (integromat), and build a real-time dashboard showing which terms are most active, who's contributing, etc.

Setup time: 30 minutes with Zapier, hours with custom solution

See: Webhooks & Automations

Scenario 5: Data Export Pipeline

Tools: Webhooks + Custom App

Automatically sync your define.wtf dictionary to an internal wiki, knowledge base, or searchable database. Updates happen in real-time as definitions change.

Setup time: 2-4 hours (development)

See: Webhooks & Automations

Setup Guide by Role

I'm an End User

You likely don't need to set up integrations; your admins handle that. But here's what integrations might affect you:

  • Slack — You might have access to /define in Slack (check with your admin)
  • SSO — You might log in with company credentials instead of a separate password
  • SCIM — Your account might have been created automatically when you were added to your company's directory

I'm an Admin

You manage integrations for your team. Start here:

  1. Slack: Quick Setup Guide — 5 minutes
  2. SSO: Setup Wizard Guide — 20 minutes
  3. SCIM: Configuration Guide — 15 minutes
  4. Webhooks: Setup and Testing — 30 minutes

I'm a Developer

You're building custom integrations. Check out:

  • Webhooks Reference — Listen to all define.wtf events in real-time
  • REST API — Query and manipulate define.wtf programmatically
  • SCIM API — Build SCIM connectors for custom IdPs

Best Practices

  • Start with SSO — If you're setting up multiple integrations, configure SSO first to streamline user access
  • Add SCIM next — Once SSO is working, SCIM eliminates manual user management
  • Slack for discovery — Enable Slack integration so your team discovers definitions in their daily workflow
  • Webhooks for automation — Use webhooks to synchronize define.wtf with your other systems

Integration Permissions

Most integrations require admin-level permissions:

IntegrationPermission Required
Slacktenant:manage_settings
SSOtenant:manage_settings
SCIMtenant:manage_settings
Webhooks (Admin)tenant:manage_webhooks
REST API (Public)None (public read), acronym:edit_any for write

Support

If you encounter issues with integrations:

  1. Check the specific integration guide for troubleshooting steps
  2. Review your audit logs (in AdminActivity) for error details
  3. Contact support@define.wtf with:
    • Which integration you're setting up
    • What error you're seeing
    • Steps you've already taken to troubleshoot

What's Coming

Future integrations in development:

  • GitHub integration (mention acronyms in PRs/issues)
  • Microsoft Teams support
  • Custom OAuth app builder
  • Additional automation platforms