api-gateway

Files (197)

• origin.json · .clawhub/
• LICENSE.txt
• SKILL.md
• _meta.json
• README.md · references/active-campaign/
• README.md · references/acuity-scheduling/
• README.md · references/airtable/
• README.md · references/apollo/
• README.md · references/asana/
• README.md · references/attio/
• README.md · references/basecamp/
• README.md · references/baserow/
• README.md · references/beehiiv/
• README.md · references/box/
• README.md · references/brevo/
• README.md · references/cal-com/
• README.md · references/calendly/
• README.md · references/callrail/
• README.md · references/chargebee/
• README.md · references/clickfunnels/
• README.md · references/clicksend/
• README.md · references/clickup/
• README.md · references/clio/
• README.md · references/clockify/
• README.md · references/coda/
• README.md · references/cognito-forms/
• README.md · references/companycam/
• README.md · references/confluence/
• README.md · references/constant-contact/
• README.md · references/dropbox-business/
• README.md · references/dropbox/
• README.md · references/elevenlabs/
• README.md · references/eventbrite/
• README.md · references/fathom/
• README.md · references/firebase/
• README.md · references/fireflies/
• README.md · references/getresponse/
• README.md · references/github/
• README.md · references/google-ads/
• README.md · references/google-analytics-admin/
• README.md · references/google-analytics-data/
• README.md · references/google-bigquery/
• README.md · references/google-calendar/
• README.md · references/google-classroom/
• README.md · references/google-contacts/
• README.md · references/google-docs/
• README.md · references/google-drive/
• README.md · references/google-forms/
• README.md · references/google-mail/
• README.md · references/google-meet/
• README.md · references/google-merchant/
• README.md · references/google-play/
• README.md · references/google-search-console/
• README.md · references/google-sheets/
• README.md · references/google-slides/
• README.md · references/google-tasks/
• README.md · references/google-workspace-admin/
• README.md · references/granola-mcp/
• get_meeting_transcript.json · references/granola-mcp/schemas/
• get_meetings.json · references/granola-mcp/schemas/
• …and 137 more

SKILL.md (first lines)

# API Gateway

Passthrough proxy for direct access to third-party APIs using managed OAuth connections, provided by [Maton](https://maton.ai). The API gateway lets you call native API endpoints directly.

## Quick Start

```bash
# Native Slack API call
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'channel': 'C0123456', 'text': 'Hello from gateway!'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```


## Base URL

```
https://gateway.maton.ai/{app}/{native-api-path}
```

Replace `{app}` with the service name and `{native-api-path}` with the actual API endpoint path.

IMPORTANT: The URL path MUST start with the connection's app name (eg. `/google-mail/...`). This prefix tells the gateway which app connection to use. For example, the native Gmail API path starts with `gmail/v1/`, so full paths look like `/google-mail/gmail/v1/users/me/messages`.

## Authentication

All requests require the Maton API key in the Authorization header:

```
Authorization: Bearer $MATON_API_KEY
```

The API gateway automatically injects the appropriate OAuth token for the target service.

**Environment Variable:** You can set your API key as the `MATON_API_KEY` environment variable:

```bash
export MATON_API_KEY="YOUR_API_KEY"
```

## Getting Your API Key

1. Sign in or create an account at [maton.ai](https://maton.ai)
2. Go to [maton.ai/settings](https://maton.ai/settings)
3. Click the copy button on the right side of API Key section to copy it

## Connection Management

Connection management uses a separate base URL: `https://ctrl.maton.ai`

### List Connections

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Query Parameters (optional):**
- `app` - Filter by service name (e.g., `slack`, `hubspot`, `salesforce`)
- `status` - Filter by connection status (`ACTIVE`, `PENDING`, `FAILED`)

**Response:**
```json
{
  "connections": [
    {
      "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
      "status": "ACTIVE",
      "creation_time": "2025-12-08T07:20:53.488460Z",
      "last_updated_time": "2026-01-31T20:03:32.593153Z",
      "url": "https://connect.maton.ai/?session_token=5e9...",
      "app": "slack",
      "method": "OAUTH2",
      "metadata": {}
    }
  ]
}
```

### Create Connection

```bash
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'slack'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Request Body:**
- `app` (required) - Service name (e.g., `slack`, `notion`)
- `method` (optional) - Connection method (`API_KEY`, `BASIC`, `OAUTH1`, `OAUTH2`, `MCP`)

### Get Connection

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Response:**
```json
{

From bobvarkey/diabetes-buddy, MIT.

More from bobvarkey/diabetes-buddy