TMF621 v4 Trouble Ticket Management API
The TMF Trouble Ticket API (TMF 621) provides a standardised client interface to Trouble Ticket Management Systems for creating, tracking and managing trouble tickets as a result of an issue or problem identified by a customer or another system.
The API supports the ability to send requests to create a new trouble ticket specifying the nature and severity of the trouble or issue as well as all necessary related information. The API also includes mechanisms to search for and update existing trouble tickets.
The Trouble Ticket Management API is certified by TM Forum.
- For TMF Open API release and specification version, see Industry API Version.
- Starting from Summer'26, TMF621 v4 Trouble Ticket Management API will be redacted. It is recommended to use TMF621 v5 Trouble Ticket Management API.
For the Spring'26 and Summer'26 releases, TMF621 v4 API can be accessed using either of the following methods.
- Mule Gateway: Access API through standard MuleSoft endpoints. For sample URLs, payloads, and parameter descriptions, see Reference section for details on TMF621 v4 MuleSoft endpoints.
- Direct Access: Bypass Mule Gateway using Connect/Apex REST endpoints.
- See TMF621 v4 Use Cases section for sample URLs and payloads.
- See TMF621 v4 Resource Mappings section for parameter descriptions.
Starting from the Winter ’27 release, only the Direct Access option will be supported. The MuleSoft gateway option will be deprecated, and customers must update their integrations to use the Connect/Apex REST endpoints for continued access to the inbound APIs.
TMF621 v4 resources are available as static resources. Import the TMF621 v4 components to your Salesforce org. See Import TMFOpenAPI Static Resources.
TMF621 v4 API uses the following URL format:
{https://MyDomainLoginUrl}/services/apexrest/{namespace}/tmforum/troubleticket/v57.0/troubleticket.
To access and use the TMF621 v4 API:
- Read and accept the terms and conditions of usage. See Accept Terms and Enable Access.
- Authorize and use a connected app and an OAuth 2.0 authorization flow. See Authorize Access.
- Trigger the API call. Refer the above section for sample URL.
- Use the TMF621 API available resources and API endpoints.
- See TMF621 v4 Use Cases section for sample URLs and payloads.
- See TMF621 v4 Resource Mappings section for parameter descriptions.
- Based on the requirements, extend and customize TMF621 API. Extend the TMF621 API.