> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitl.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations Overview

> Connect HITL.sh to your existing tools and workflows. Choose from SDKs, workflow tools, or custom integrations.

## Integration Methods

HITL.sh integrates with your existing systems through multiple channels, giving you flexibility to add human supervision without disrupting your current workflows.

> [!NOTE]
>
> Before configuring any integration, install the HITL.sh mobile app ([App Store](https://apps.apple.com/us/app/hitl-human-in-the-loop/id6752878072) | [Google Play](https://play.google.com/store/apps/details?id=hitl.sh.app)) since it's an integral part of the setup.

## Integration Options

### Software Development Kits (SDKs)

> [card] [Python SDK](https://docs.hitl.sh/integrations/python.md)
>
> Simple Python integration for AI applications and workflows

> [card] [TypeScript SDK](https://docs.hitl.sh/sdks.md)
>
> Full-featured TypeScript SDK for Node.js and browser environments

**SDK benefits:**

* **Native language support**: Use familiar syntax and patterns
* **Type safety**: Full TypeScript definitions and Python type hints
* **Error handling**: Built-in error handling and retry logic
* **Documentation**: Comprehensive examples and API reference

### Workflow Automation Tools

> [card] [n8n Integration](https://docs.hitl.sh/integrations/n8n.md)
>
> Native n8n node for seamless workflow automation

> [card] [Make.com Integration](https://docs.hitl.sh/integrations/make.md)
>
> Connect HITL.sh to your Make.com scenarios

**Workflow tool benefits:**

* **Visual interface**: Drag-and-drop workflow design
* **Pre-built nodes**: Ready-to-use HITL.sh integration
* **No coding required**: Configure through UI
* **Workflow templates**: Reusable workflow patterns

### AI Framework Integrations

> [card] [LangGraph](https://docs.hitl.sh/concepts/ai-agents.md)
>
> Integrate with LangGraph for sophisticated AI agent workflows

> [card] [MCP Server](https://docs.hitl.sh/integrations/cli.md)
>
> Model Context Protocol server for AI agent communication

**AI framework benefits:**

* **Native AI workflows**: Built for AI agent architectures
* **State management**: Handle complex workflow states
* **Agent coordination**: Coordinate multiple AI agents
* **Context preservation**: Maintain context across review cycles

### Custom Integrations

> [card] [HTTP API](https://docs.hitl.sh/api-reference/introduction.md)
>
> RESTful API for custom integrations and webhook handling

**Custom integration benefits:**

* **Full control**: Customize integration to your needs
* **Any language**: Use any programming language or framework
* **Custom logic**: Implement business-specific requirements
* **Scalability**: Handle high-volume integrations

## Integration Patterns

### Request-Response Pattern

The most common integration pattern for simple review workflows:

```mermaid theme={null}
graph LR
    A[AI System] --> B[HITL.sh API]
    B --> C[Human Review]
    C --> D[Webhook Response]
    D --> A
```

**Use cases:**

* Content moderation
* Quality assurance
* Simple approval workflows
* Single-step reviews

### Event-Driven Pattern

For complex workflows with multiple review steps:

```mermaid theme={null}
graph LR
    A[AI Workflow] --> B[Review Step 1]
    B --> C[Human Review 1]
    C --> D[AI Processing]
    D --> E[Review Step 2]
    E --> F[Human Review 2]
    F --> G[Final Output]
```

**Use cases:**

* Multi-stage content creation
* Iterative improvement workflows
* Complex decision trees
* Quality gates

### Streaming Pattern

For real-time review processes:

```mermaid theme={null}
graph LR
    A[AI Stream] --> B[Real-time Review]
    B --> C[Live Feedback]
    C --> A
```

**Use cases:**

* Live content generation
* Real-time quality control
* Interactive AI systems
* Continuous learning

## Authentication & Security

### API Keys

**Secure access:**

* **API key generation**: Create keys through the dashboard
* **Key rotation**: Regular key rotation for security
* **Scope restrictions**: Limit key permissions
* **Usage monitoring**: Track API key usage

### Webhook Security

**Secure webhooks:**

* **Signature verification**: Signed payloads for security
* **HTTPS only**: All webhooks use encrypted connections
* **Retry logic**: Automatic retry for failed deliveries
* **Rate limiting**: Protection against abuse

### Access Control

**Permission management:**

* **Role-based access**: Different permission levels
* **Team isolation**: Separate data between teams
* **Audit logging**: Complete access history
* **IP restrictions**: Optional IP whitelisting

## Performance & Reliability

### API Performance

**Optimized for speed:**

* **Low latency**: API responses in milliseconds
* **High throughput**: Handle thousands of requests per minute
* **Global distribution**: Low-latency access worldwide
* **Connection pooling**: Efficient connection management

### Webhook Reliability

**Reliable delivery:**

* **Automatic retries**: Retry failed webhook deliveries
* **Dead letter queues**: Handle permanently failed webhooks
* **Delivery confirmation**: Track webhook delivery status
* **Fallback options**: Alternative delivery methods

### Monitoring & Alerts

**Health monitoring:**

* **Uptime monitoring**: 99.9% uptime guarantee
* **Performance metrics**: Track response times and throughput
* **Error tracking**: Monitor and alert on errors
* **Integration health**: Check integration status

## Getting Started

### Choose Your Integration

**For developers:**

* Start with the SDK for your preferred language
* Use the HTTP API for custom requirements
* Check our examples and templates

**For non-developers:**

* Use n8n or Make.com integrations
* Leverage pre-built workflow templates
* Start with simple approval workflows

### Integration Checklist

**Before you start:**

* [ ] Choose integration method
* [ ] Set up HITL.sh account
* [ ] Generate API keys
* [ ] Configure webhook endpoints
* [ ] Test with sample data
* [ ] Monitor integration health

### Best Practices

**Integration tips:**

* **Start simple**: Begin with basic review workflows
* **Error handling**: Implement robust error handling
* **Monitoring**: Track integration performance
* **Documentation**: Document your integration patterns
* **Testing**: Test thoroughly before production

## Next Steps

> [card] [Python SDK](https://docs.hitl.sh/integrations/python.md)
>
> Get started with Python integration for your AI workflows.

> [card] [TypeScript SDK](https://docs.hitl.sh/sdks.md)
>
> Use TypeScript for Node.js and browser integrations.

> [card] [n8n Integration](https://docs.hitl.sh/integrations/n8n.md)
>
> Add human supervision to your n8n workflows.

> [card] [API Reference](https://docs.hitl.sh/api-reference/introduction.md)
>
> Complete API documentation for custom integrations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.