Base URL: https://api.pachca.com/api/shared/v1
Authorization: Authorization: Bearer <ACCESS_TOKEN>
Token: bot (Automations → Integrations → API) or user (Automations → API).
If the token is unknown — ask the user before executing requests.
Available skills
| Skill | When to use |
|---|---|
| pachca-profile | get profile, my profile, set status |
| pachca-users | find employee, create user, list employees |
| pachca-chats | create channel, create conversation, create chat |
| pachca-messages | send message, reply in thread, attach file |
| pachca-bots | configure bot, webhook, webhook |
| pachca-forms | show form, interactive form, modal window |
| pachca-tasks | create task, list tasks, reminder |
| pachca-search | search messages, find message, full-text search |
| pachca-security | audit, event log, security |
Quick start
- Get a token: Automations → Integrations → API (bot) or Automations → API (user)
- Determine the task → choose a skill from the table above
- Open the SKILL.md of the required skill → follow the step-by-step scenario
General rules
- Pagination: cursor-based (
limit+cursor), NOT page-based - Rate limit: ~50 req/sec, messages ~4 req/sec
- Format: JSON (
Content-Type: application/json) - Errors: 422 (parameters), 429 (rate limit), 403 (no access), 404 (not found)