API
REST API reference documentation. 147 services with authentication, endpoints, and gotchas.
Setup
On first use, read setup.md for usage guidelines.
When to Use
User asks about integrating a third-party API. This skill provides:
- - Authentication documentation
- Endpoint reference with curl examples
- Rate limits and pagination patterns
- Common mistakes to avoid
Architecture
CODEBLOCK0
Quick Reference
| File | Purpose |
|---|
| INLINECODE1 | Usage guidelines |
| INLINECODE2 |
Multi-account credential naming (
{SERVICE}_{ACCOUNT}_{TYPE}) |
|
auth.md | Authentication patterns |
|
pagination.md | Pagination patterns |
|
resilience.md | Error handling patterns |
|
webhooks.md | Webhook patterns |
API Categories
| Category | File | Services |
|---|
| AI/ML | INLINECODE8 | anthropic, openai, cohere, groq, mistral, perplexity, huggingface, replicate, stability, elevenlabs, deepgram, assemblyai, together, anyscale |
| Payments |
apis/payments.md | stripe, paypal, square, plaid, chargebee, paddle, lemonsqueezy, recurly, wise, coinbase, binance, alpaca, polygon |
| Communication |
apis/communication.md | twilio, sendgrid, mailgun, postmark, resend, mailchimp, slack, discord, telegram, zoom |
| Realtime |
apis/realtime.md | sendbird, stream-chat, pusher, ably, onesignal, courier, knock, novu |
| CRM |
apis/crm.md | salesforce, hubspot, pipedrive, attio, close, apollo, outreach, gong |
| Marketing |
apis/marketing.md | drift, crisp, front, customer-io, braze, iterable, klaviyo |
| Developer |
apis/developer.md | github, gitlab, bitbucket, vercel, netlify, railway, render, fly, digitalocean, heroku, cloudflare, circleci, pagerduty, launchdarkly, split, statsig |
| Database |
apis/database.md | supabase, firebase, planetscale, neon, upstash, mongodb, fauna, xata, convex, appwrite |
| Auth |
apis/auth-providers.md | clerk, auth0, workos, stytch |
| Media |
apis/media.md | cloudinary, mux, bunny, imgix, uploadthing, uploadcare, transloadit, vimeo, youtube, spotify, unsplash, pexels, giphy, tenor |
| Social |
apis/social.md | twitter, linkedin, instagram, tiktok, pinterest, reddit, twitch |
| Productivity |
apis/productivity.md | notion, airtable, google-sheets, google-drive, google-calendar, dropbox, linear, jira, asana, trello, monday, clickup, figma, calendly, cal, loom, typeform |
| Business |
apis/business.md | shopify, docusign, hellosign, bitly, dub |
| Geo |
apis/geo.md | openweather, mapbox, google-maps |
| Support |
apis/support.md | intercom, zendesk, freshdesk, helpscout |
| Analytics |
apis/analytics.md | mixpanel, amplitude, posthog, segment, sentry, datadog, algolia |
How to Navigate API Files
Each category file contains multiple APIs. Use the index at the top of each file:
- 1. Read the index first — Each file starts with an index table showing API names and line numbers
- Jump to specific API — Use the line number to read only that section (50-100 lines each)
- Example:
CODEBLOCK1
Core Rules
- 1. Find the right file first — Use the API Categories table to locate the service.
- 2. Read the index, then jump — Each file has an index. Read only the section you need.
- 3. Include Content-Type — POST/PUT/PATCH requests need
Content-Type: application/json.
- 4. Handle rate limits — Check
X-RateLimit-Remaining header. Implement backoff on 429.
- 5. Validate responses — Some APIs return 200 with error in body. Check response structure.
- 6. Use idempotency keys — For payments and critical operations.
Common Mistakes
- - Missing
Content-Type: application/json on POST requests - API keys in URL query params (use headers instead)
- Ignoring pagination (most APIs default to 10-25 items)
- No retry logic for 429/5xx errors
- Assuming HTTP 200 means success
Scope
This skill is documentation only. It provides:
- - API endpoint reference
- Authentication patterns
- Code examples for reference
The user manages their own API keys and runs commands themselves.
External Endpoints
This skill documents external APIs. Example endpoints shown are for the respective service providers (Stripe, OpenAI, etc.).
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
http — HTTP request patterns - INLINECODE29 — Webhook handling
- INLINECODE30 — JSON processing
Feedback
- - If useful: INLINECODE31
- Stay updated: INLINECODE32
