Getting Started
From a new account to your first ticket, in six steps.
1. Create Your Account
Sign up at desk.pimi.io/register, confirm your email address with the link we send, then choose a plan.
A new subscription starts with a 14-day trial. You enter a card at Paddle checkout and are charged when the trial ends. During the trial a workspace can receive mail and reply to it, but cannot start a new thread.
2. Create a Workspace
Workspaces are isolated environments for managing tickets, contacts, and conversations. Each workspace has its own email addresses, tags, and team members.
Go to Dashboard → Create Workspace and give it a name. PimiDesk generates a unique URL slug automatically.
Your plan determines how many workspaces you can create: Lite 1, Pro 2, Business 3.
3. Add an Email Address
Navigate to Emails in your workspace sidebar. You have two options:
Platform Email (Quickest)
PimiDesk provides a ready-to-use email address on the pimidesk.com domain. Add one and you can start receiving tickets immediately — no DNS configuration needed.
Custom Domain Email
Use your own domain (e.g., [email protected]). This requires:
- Adding a domain in the Domains tab and verifying ownership via DNS TXT record
- Setting up DKIM for outbound email verification
- Configuring email forwarding or MX records to route inbound mail to PimiDesk
Each email has a purpose setting that controls where inbound emails are routed:
ticket— inbound emails create or thread into tickets (structured support with status, priority, and SLA tracking)inbox(no user assigned) — inbound emails create or thread into shared conversations, visible to all workspace membersinbox(with a user assigned) — inbound emails create or thread into personal conversations, visible only to the assigned user
4. Receive Your First Ticket
Send an email to the address you just configured. PimiDesk's email pipeline will:
- Receive the email and check the sender's SPF, DKIM and DMARC results
- Create a new contact (or match an existing one) from the sender
- Create a ticket with the email subject and body
- Store any attachments
- Track CC recipients
The ticket appears in your workspace dashboard. Reply from the dashboard and your response is sent as an email back to the customer.
5. Use the API
Every operation in PimiDesk is available via the REST API. Generate a personal access token from your API Tokens page (in the user menu).
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://desk-api.pimi.io/api/v1/workspaces/WORKSPACE_ID/tickets The API Reference lists all 250+ operations with interactive examples. To work the queue from Claude or ChatGPT instead, follow the MCP Server guide.
6. Invite Your Team
Go to Members in your workspace sidebar. Invite team members by email — they'll receive an invitation link to join your workspace. Members can create tickets, respond to customers, and manage contacts. Only workspace owners can manage settings, SLA policies, and billing.
Next Steps
- Email Pipeline Guide — Deep dive into email routing, threading, and forwarding
- Webhooks Guide — Get notified when tickets, conversations, or contacts change
- Workspaces & Teams — Multi-workspace setup, roles, and quotas
- API Reference — Interactive documentation for all endpoints