| name | poke |
| description | Build with the Poke developer SDK and REST API โ send messages to a user's Poke agent, create webhook triggers, authenticate with API keys, and understand the platform (channels, Kitchen, integrations, recipes). Use when the user asks to "send a message to Poke", "call the Poke API", "use the poke npm package", "integrate with poke.com", or builds anything against `poke.com/api/v1`. |
| license | MIT |
| compatibility | Requires Node.js >= 18 for the SDK. The REST endpoint can be called from any HTTP client. |
| metadata | {"author":"HKTITAN","version":"1.1.0","graph":true} |
Poke SDK & API โ Map of Content
Poke is a personal AI agent by Interaction Company. The poke npm package and REST API let you send the agent messages and create webhook triggers programmatically.
This skill is structured as a graph: scan the descriptions below, follow only the [[wikilinks]] you need. Don't read every node up front.
Platform context
- [[references/overview]] โ what Poke is, channels (iMessage / Telegram / SMS), languages, status.
- [[references/kitchen]] โ the developer dashboard at poke.com/kitchen.
- [[references/use-cases]] โ canonical API patterns: desktop capture, event automation, service bridging.
Setup
- [[references/installation]] โ installing the npm package, Node version requirements.
- [[references/api-keys]] โ getting a V2 key, the V1 vs V2 trap.
- [[references/credential-resolution]] โ order in which
Poke() finds an API key.
SDK methods (one node per method)
- [[references/send-message]] โ
poke.sendMessage(text): fire one message at the agent.
- [[references/create-webhook]] โ
poke.createWebhook({ condition, action }): mint a persistent trigger.
- [[references/send-webhook]] โ
poke.sendWebhook({ webhookUrl, webhookToken, data }): fire an existing trigger.
Talking to the API directly
- [[references/rest-endpoint]] โ
POST /api/v1/inbound/api-message from any language.
When things go wrong
- [[references/auth-errors]] โ
PokeAuthError, retry rules, key rotation.
- [[references/async-semantics]] โ what
success: true actually means.
Sibling skills
- [[../poke-webhooks/SKILL]] โ designing condition/action pairs and wiring event sources.
- [[../poke-mcp-tunnel/SKILL]] โ the
poke CLI: login, registering a remote MCP, tunneling localhost.
- [[../poke-recipes/SKILL]] โ creating shareable Recipe install bundles.
- [[../poke-integrations/SKILL]] โ pre-built integrations and connecting custom MCPs to a user's Poke.
Reference links
