Preview before write Diffs, policy posture, and rollback readiness appear before the connector executes.
Simulation or sandbox first The product starts with a deterministic story before it asks for production trust.
Proof stays attached Approval, audit, artifacts, and recovery context stay on the same governed run.
Connector

Freshdesk Ticketing

Use this checklist to move from stored Freshdesk credentials to a validated ticket-resolution workflow with rollback evidence.

Overview
Freshdesk Ticketing

Freshdesk Ticketing is best evaluated in a vendor trial workspace first, with one narrow ticket workflow and a visible approval or execution story.

Sandbox availability

Beta
Live sandbox path
Vendor trial
Freshdesk free trial account
First action freshdesk.resolve-ticket
Live sandbox path Connector-specific auth, metadata sync, and live sandbox write paths exist here, but the lane is still pre-pilot and not yet proven with real external tenants.
Sandbox posture Freshdesk free trial workspace
Next move Start with: Save connector settings.
Developer connection steps

Keep the first connector setup constrained to one environment, one identity, and one clearly reviewable workflow.

01
start-trial

Start a vendor trial or developer workspace

Use the vendor-provided trial or developer workspace path for Freshdesk Ticketing so the first support workflow is isolated from production.

02
create-integration-identity

Create the support integration identity

Save the Freshdesk helpdesk URL, API key, and the ticket field allowlists for status, priority, note.body, and note.private.

03
configure-actionplane

Enter the support connector settings in ActionPlane

Open the connector page in ActionPlane, save the workspace URL and credentials, and keep the first workflow scoped to one ticket or conversation path only.

04
validate-sync

Validate auth and sync writable ticket metadata

Run metadata sync so ActionPlane can validate Freshdesk ticket fields and writable resolution controls before live writes.

05
run-first-sample

Run one low-risk ticket sample first

Submit the Freshdesk resolve-ticket preset as a dry run from the dashboard and confirm that the preview, governance decision, and artifacts look correct.

Canonical sample scenario

Business context

A support team wants to resolve one low-risk ticket or conversation while keeping reply posture and status visible to the operator.

Starting record state

One sample ticket is open with a draft resolution summary and a pending decision on whether the response stays internal or becomes customer-facing.

Requested change

Mark the ticket resolved, keep the note scoped correctly, and attach the reviewed resolution summary.

Why it routes

This sample makes the operator decision legible even when the connector is only available through a vendor trial.

Expected artifacts

Action request, preview, output, and audit evidence should make the support update explainable after the fact.

Reset behavior

Reset should clear the trial workspace data or return the ActionPlane sample state to the original unresolved ticket.

Onboarding API
Use an authenticated ActionPlane session or bearer token. These endpoints act on the current workspace by default, so connector setup stays inside the same operator context as the UI.
GET /api/connectors/onboarding/freshdesk-ticketing
GET /api/connectors/onboarding/freshdesk-ticketing/metering
POST /api/connectors/onboarding/freshdesk-ticketing/connect
POST /api/connectors/onboarding/freshdesk-ticketing/validate
POST /api/connectors/onboarding/freshdesk-ticketing/sync-metadata

Onboarding metering tracks activation progress for the connector. It is not a separate billable unit; workspace billing remains governed-run based.

Connect payload

Save the connector, validate it immediately, and sync metadata in one authenticated call.

{
  "instanceUrl": "https://contoso.freshdesk.com",
  "clientId": "\u003Capi-key\u003E",
  "clientSecret": "\u003Cleave-empty\u003E",
  "isSandbox": true,
  "isEnabled": true,
  "validateAfterSave": true,
  "syncMetadataAfterSave": true,
  "managedObjects": [
    {
      "objectApiName": "tickets",
      "displayName": "Tickets",
      "allowedFields": [
        "status",
        "priority",
        "note.body",
        "note.private"
      ]
    }
  ]
}
curl -X POST \
  "$ACTIONPLANE_BASE_URL/api/connectors/onboarding/freshdesk-ticketing/connect" \
  -H "Authorization: Bearer <session-token>" \
  -H "Content-Type: application/json" \
  --data @"connect-freshdesk-ticketing.json"
Validate

Re-run auth and instance validation without resubmitting the connector payload.

curl -X POST \
  "$ACTIONPLANE_BASE_URL/api/connectors/onboarding/freshdesk-ticketing/validate" \
  -H "Authorization: Bearer <session-token>" \
  -H "Content-Type: application/json"
Sync metadata

Refresh the writable object and field catalog after credentials or allowlists change.

curl -X POST \
  "$ACTIONPLANE_BASE_URL/api/connectors/onboarding/freshdesk-ticketing/sync-metadata" \
  -H "Authorization: Bearer <session-token>" \
  -H "Content-Type: application/json"
Capabilities

Visible ticket or case state preview before execution

Connector-aware approval and simulation posture

Audit, evidence, and rollback context attached to the same support run

First-class onboarding API can save, validate, and sync the connector in one authenticated flow

Go live

Start with one sandbox record or ticket that accurately mirrors production shape and permissions.

Validate preview, approval, output evidence, and recovery posture before widening workflow scope.

Move to production only after the first evaluator can demo the path without founder narration.

Known limits

This lane depends on a vendor trial or development workspace rather than a built-in ActionPlane simulation.

Ticketing trials often include product or messaging restrictions that do not match a paid production tenant exactly.

Treat the first workflow as beta and validate reply posture carefully before going live.