# API Connector

> Connect to external APIs, process responses, and build integrations. TRIGGERS - Use when user wants to connect APIs, build integrations, or process API data.

- Skill: `winbda/api-connector` (Agent Skill)
- Install (CLI): `npx skillmds add winbda/api-connector`
- Raw SKILL.md: https://api.skillmd.com/api/skills/winbda/api-connector/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Winbda (https://skillmd.com/u/winbda)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/winbda/api-connector

---


# API Connector

## Overview
Designs and implements API integrations including authentication, request formatting, response parsing, and error handling.

## Workflow

### Step 1: Define the Integration
1. **API**: Which service are you connecting to?
2. **Purpose**: What data do you need or what action to trigger?
3. **Direction**: Read data, write data, or both?
4. **Platform**: Where is this running? (n8n, Make, Zapier, custom code)
5. **Frequency**: One-time, on-demand, or scheduled?

### Step 2: Map the Integration

```markdown
[SOURCE] → [API Call] → [PROCESS] → [DESTINATION]
```

### Step 3: Build the Connection

For each API call, document:

```markdown
## API Call: [Name]

### Endpoint
`[METHOD] [URL]`

### Authentication
- **Type**: [API key, OAuth2, Bearer token]
- **Setup**: [How to get credentials]

### Request
**Headers:**
```json
{
  "Authorization": "Bearer {{API_KEY}}",
  "Content-Type": "application/json"
}
```

**Body (if POST/PUT):**
```json
{
  "field": "{{value}}"
}
```

### Response
**Success (200):**
```json
{
  "data": { ... }
}
```

**Fields to extract:**
| Field | Path | Use |
|-------|------|-----|
| [name] | response.data.name | [purpose] |

### Error Handling
| Status | Meaning | Action |
|--------|---------|--------|
| 400 | Bad request | Check input format |
| 401 | Unauthorized | Refresh token |
| 429 | Rate limited | Wait and retry |
| 500 | Server error | Retry with backoff |
```

## Output Format
Complete integration documentation with code samples for the user's platform.

## Quality Checklist
- [ ] Authentication method documented
- [ ] Request format with examples
- [ ] Response parsing specified
- [ ] Error handling for common status codes
- [ ] Rate limiting considered
- [ ] Test endpoint provided