Freshdesk

Use the @bijection/connectors/freshdesk entrypoint to declare Freshdesk resources.

Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. Source build and package availability.

Resources and modes

Resource	Mode	Description
Tickets	`changes`	Tickets by updated_since with the deleted view as deletions

Declare a resource in application code, then bind deployment-specific settings and credentials. See typed resources, connections and source inspection.

Tickets

changes: Tickets by updated_since with the deleted view as deletions

The following example matches configuration standard.

import { freshdesk } from "@bijection/connectors/freshdesk";
export const source = freshdesk.tickets.changes();

Inferred record types

Resource without an operational record table

Configuration: standard

Case: freshdesk/tickets/changes/standard. Connection and resource configuration are declared by this exact case. Credential kind: freshdesk. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`domain`	string	Yes	Shared connection

Provider setup requirements:

[
  {
    "key": "domain",
    "supplier": "account",
    "label": "Freshdesk domain",
    "help": "The name in your helpdesk address, <domain>.freshdesk.com.",
    "docUrl": "https://developers.freshdesk.com/api/#authentication",
    "example": "acme",
    "prefix": "https://",
    "suffix": ".freshdesk.com/api/v2/",
    "pattern": "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?",
    "minLength": 1,
    "maxLength": 63,
    "fills": "base_url"
  }
]

Complete configuration contract

{
  "setup": [
    {
      "key": "domain",
      "supplier": "account",
      "label": "Freshdesk domain",
      "help": "The name in your helpdesk address, <domain>.freshdesk.com.",
      "docUrl": "https://developers.freshdesk.com/api/#authentication",
      "example": "acme",
      "prefix": "https://",
      "suffix": ".freshdesk.com/api/v2/",
      "pattern": "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?",
      "minLength": 1,
      "maxLength": 63,
      "fills": "base_url"
    }
  ],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "freshdesk",
    "output": {
      "kind": "single",
      "collection": "tickets"
    },
    "credential_kind": "freshdesk",
    "connection_fields": [
      "domain"
    ],
    "address": {
      "kind": "setup",
      "field": "domain",
      "prefix": "https://",
      "suffix": ".freshdesk.com/api/v2/"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "domain": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: tickets

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Explicit deletion evidence
Resume	Opaque cursor
Gap	Explicit repair required after a gap
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "deleted": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "live": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "point": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "404": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange deleted",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange live",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.3",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange point",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2",
          "acquire.3"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "explicit_events",
  "resume": "opaque_cursor",
  "retentionMs": null,
  "gap": "explicit_repair",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "tickets": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": true,
      "reconciliation": true,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "deleted": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "live": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "point": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "404": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange deleted",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange live",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.3",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange point",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2",
                "acquire.3"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "explicit_events",
        "resume": "opaque_cursor",
        "retentionMs": null,
        "gap": "explicit_repair",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {}
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {}
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“tickets”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
watermark-boundary-replay	{“kind”:“collection”,“name”:“tickets”}	Fixture: ./src/connectors/freshdesk/fixtures/boundary-replay-ends-phase.json	passed (2026-10-24T21:36:12.051Z)
watermark-empty-page-ends	{“kind”:“collection”,“name”:“tickets”}	Fixture: ./src/connectors/freshdesk/fixtures/empty-deleted-view-carries-live-bound.json	passed (2026-10-24T21:36:12.052Z)
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/freshdesk/fixtures/identity.json	passed (2026-10-24T21:36:12.052Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Provider guidance

Compiled declaration examples and configuration details are published in the connector reference. The connection is one helpdesk (domain fills https://<domain>.freshdesk.com/api/v2/), authorized by an API key as HTTP Basic <key>:X (a basic envelope). tickets.changes walks live tickets by updated_since with order_by=updated_at&order_type=asc: each request asks from the largest updated_at the previous page returned, a cursor the host derives from the retained page, so Freshdesk’s 300-page cap never binds. It then walks the deleted view (filter=deleted) from the beginning on every pass, because a soft delete is not documented to move updated_at; its tickets are withdrawn, and a restored ticket reappears in the live view. A finished pass carries the live bound and the next begins five minutes before it. Point reconciliation re-reads known tickets and never withdraws one. Whether filter=deleted honours updated_since and the sort is undocumented: a page that ignored either fails rather than being trusted. Nothing is written (no documented precondition). Built from the provider’s published API documentation; nothing here has run against Freshdesk or been qualified.

Provider references

Provider references and prerequisites are maintained in the connector guidance above. No separate provider-documentation review date is recorded.

Source and evidence

Canonical connector source, native analysis and check receipts. Connector artifact: 905888ea276a2a28e36981a79e8142b2547ea451c3e63162cb6915ad4a7d1305. The resource declaration examples above are compiled and compared with exact catalog declarations. Recorded checks apply only to their source, declaration and runtime identities. Configure a connection and inspect its status to establish deployment-specific readiness.

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Availability

Resources and modes

Tickets

changes: Tickets by updated_since with the deleted view as deletions

Configuration: standard

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Tickets

​changes: Tickets by updated_since with the deleted view as deletions

​Configuration: standard

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Tickets

changes: Tickets by updated_since with the deleted view as deletions

Configuration: standard

Provider guidance

Provider references

Source and evidence