Vatoo connects to Freshdesk via the REST API v2 using your account's API Key, giving your AI bot live read and write access to your helpdesk. Once connected you can enable individual components · Tickets, Contacts, Companies, Agents · and control exactly which operations the bot can perform. Deflect repetitive queries, create tickets automatically, and let your bot update ticket status without any human intervention.
Confirm connector availability, your account plan, and required permissions before setup. Test with a non-production record before enabling live actions.
Setup overview · illustrative
The API key is unique per agent. Use an admin account's key for full access.
The integration name is just a friendly label. You can name it anything.
Enable write access only for operations you want the bot to perform automatically. Start with read-only.
401 Unauthorized · test connection fails
API key is wrong or was not copied fully. Re-copy from Freshdesk Profile Settings → Your API Key. Also confirm the subdomain is correct (no https://, no trailing slash).
Subdomain not found / DNS error
Make sure you entered just the subdomain part (e.g. "acme" not "acme.freshdesk.com"). If you're on an EU data centre your subdomain may differ · check your login URL carefully.
Ticket search returns no results
Freshdesk search requires at least one filter. Try adding a status or date range. Full-text search indexes ticket subjects and descriptions · ensure the query word appears in ticket content.
Create ticket fails with 422
Subject and requester email are required to create a ticket. Ensure the bot passes both params. The email must be a valid address.
Reply fails with 403
The API key owner may not have permission to reply on tickets. Use an admin account's API key, or check agent permissions in Freshdesk Admin → Roles.
Book a demo and we'll set up the integration with you live.