Skip to main content
The Integration Requests API allows users to submit requests for integrations that are not yet available in Hazel Chat. This helps the team prioritize and build integrations that the community needs.

​
Overview

Organizations can submit integration requests to express interest in connecting Hazel Chat with external platforms and services. The Hazel team reviews these requests to prioritize development.

​
Create Integration Request

Submit a new integration request. 
import { integrationRequest } from "@hazel/domain/rpc"

const request = await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "Jira",
  integrationUrl: "https://www.atlassian.com/software/jira",
  description: "We need Jira integration to track issues and link them to chat discussions"
})
​
organizationId
OrganizationId
required
The organization submitting the request
​
integrationName
string
required
Name of the requested integration (e.g., “Jira”, “Figma”, “Linear”)
​
integrationUrl
string
URL to the integration’s website or documentation
​
description
string
Detailed description of how you want to use this integration and what features you need
Response
​
data
IntegrationRequest
The created integration request
​
transactionId
TransactionId
Transaction ID for optimistic updates
Errors
  • UnauthorizedError - Not authorized to submit requests
  • InternalServerError - Server error

​
Example Requests

​
Development Tools

// Request GitHub Actions integration
await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "GitHub Actions",
  integrationUrl: "https://github.com/features/actions",
  description: "We want to receive GitHub Actions workflow notifications in our deployment channels"
})

// Request Vercel integration
await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "Vercel",
  integrationUrl: "https://vercel.com",
  description: "Get deployment status updates and preview URLs in chat"
})

​
Project Management

// Request Jira integration
await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "Jira",
  integrationUrl: "https://www.atlassian.com/software/jira",
  description: "Link Jira issues to threads, create issues from messages, and get ticket updates"
})

// Request Asana integration
await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "Asana",
  integrationUrl: "https://asana.com",
  description: "Create tasks from messages and get project updates in chat"
})

​
Design & Collaboration

// Request Figma integration
await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "Figma",
  integrationUrl: "https://www.figma.com",
  description: "Share design links with rich previews and get notifications for comments and updates"
})

// Request Notion integration
await integrationRequest.create({
  organizationId: "org_123",
  integrationName: "Notion",
  integrationUrl: "https://www.notion.so",
  description: "Link Notion pages to channels and get updates when pages are edited"
})

​
Request Status

After submitting a request, the Hazel team will review it and update the status:
  • pending - Request submitted, awaiting review
  • reviewing - Team is evaluating the request
  • planned - Integration is scheduled for development
  • implemented - Integration is now available
  • declined - Request was declined (with explanation)
You can track the status of your integration requests in your organization settings. The team may reach out for additional details about your use case.

​
Tips for Effective Requests

Be specific about your use case. Instead of “we need Jira integration,” explain “we want to create Jira issues from messages and get status updates in our #engineering channel.”
Include the integration URL so the team can quickly understand what you’re requesting.
Popular requests from multiple organizations are prioritized. If an integration you need has already been requested, reach out to support to add your vote.

​
Existing Integrations

Before submitting a request, check if the integration is already available:
  • GitHub - Available now (docs)
  • RSS Feeds - Available now (docs)
  • Webhooks - Available now (docs)
  • Bots - Build custom integrations (docs)

Integrations Overview

See all available integrations

Build a Bot

Create custom integrations with the Bot API

Webhooks

Integrate any service with webhooks

Build docs developers (and LLMs) love

Get started for freeTalk to us