# Kapso API

> Kapso Platform API for customer onboarding, setup links, phone number provisioning, and connection detection. Use when working with multi-tenant WhatsApp integrations, embedded signup, or customer management.

- Skill: `majiayu000/kapso-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/kapso-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/kapso-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/kapso-api

---


# Kapso Platform API

## When to use

Use this skill for Platform API operations: creating customers, generating setup links, provisioning phone numbers, or detecting WhatsApp connections.

## Setup

Base host: `https://api.kapso.ai` (scripts append `/platform/v1`)

Auth header:
```
X-API-Key: <api_key>
```

## How to

### Onboard a customer

1. Create customer: `POST /customers`
2. Generate setup link: `POST /customers/:id/setup_links`
3. Customer completes embedded signup
4. Use `phone_number_id` to send messages

### Detect connection

Option A: Project webhook `whatsapp.phone_number.created`

Option B: Success redirect URL query params

Use both for best UX and backend reliability.

### Provision phone numbers

When creating a setup link, set:

```json
{
  "setup_link": {
    "provision_phone_number": true,
    "phone_number_country_isos": ["US"]
  }
}
```

## Notes

- Platform API base: `/platform/v1`
- Meta proxy base: `/meta/whatsapp/v24.0` (use for messaging and templates)
- Use `phone_number_id` as the primary WhatsApp identifier

## References

- [references/platform-api-reference.md](references/platform-api-reference.md) - Full endpoint reference
- [references/getting-started.md](references/getting-started.md) - Initial setup guide
- [references/setup-links.md](references/setup-links.md) - Setup link configuration
- [references/detecting-whatsapp-connection.md](references/detecting-whatsapp-connection.md) - Connection detection methods

## Related skills

- `kapso-automation` - Workflow automation
- `whatsapp-messaging` - WhatsApp messaging and templates
- `whatsapp-flows` - WhatsApp Flows
- `kapso-ops` - Operations and webhooks