Skip to main content

Freshservice

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Freshservice account to Nirvai to automate IT service management, manage tickets, and track assets.

Supported Authentication Methods​

  • API Key - Basic authentication with API key

Prerequisites​

Setup Instructions​

API Key Authentication​

Step 1: Get Your API Key​

  1. Log in to your Freshservice account
  2. Click on your profile icon (top right)
  3. Go to Profile Settings
  4. Find your API Key in the settings
  5. Copy the API key

Step 2: Get Your Subdomain​

Your Freshservice subdomain is part of your URL:

  • URL: https://your-company.freshservice.com
  • Subdomain: your-company

Step 3: Configure in Nirvai​

  1. In Nirvai, select Freshservice API Key
  2. Enter your Subdomain
  3. Paste your API Key
  4. Save the credential

Available Operations​

With Freshservice credentials, you can:

  • Create and manage tickets
  • Track IT assets
  • Manage service catalog
  • Handle change requests
  • Access agent and requester data

Authentication Details​

Freshservice uses Basic authentication:

  • Username: API Key
  • Password: X (literal "X")

Nirvai handles this automatically.

Troubleshooting​

Common Issues​

  • 401 Unauthorized: API key is invalid
  • Wrong Subdomain: Check your Freshservice URL
  • Insufficient Permissions: Ensure your account has API access
  • Rate Limits: Freshservice has API rate limits

Finding Your API Key​

  1. Log in to Freshservice
  2. Go to Profile Settings
  3. The API key is displayed on your profile page

Adapted from n8n documentation for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.