# TMF666 v5 Account Management API

The Billing Account Management API (TMF666) provides a standardized mechanism for billing account management, such as creation, update, retrieval, and deletion of billing accounts.

TMF666 v5 currently supports the `billingAccount` resource. Billing accounts map to the Salesforce BillingAccount object.

Using this API you can perform the following operations on billing accounts.

- Retrieve the list of billing accounts from the system
- Get billing account details based on conditions or an ID parameter
- Create a billing account
- Update an existing billing account
- Delete an existing billing account

:::note
- For TMF Open API release and specification version, see [Industry API Version](/docs/industries/communications/guide/industry_api_version.md).
:::

## Access Methods

Access TMF666 v5 API using Direct Access Connect/Apex REST endpoints.

- See [TMF666 v5 Use Cases](/docs/industries/communications/guide/TMF666use-cases.md) for sample URLs and payloads.
- See [TMF666 v5 Resource Mappings](/docs/industries/communications/guide/tmf666\_resource_mapping.md) for parameter descriptions.

:::important
Starting from the Winter ’27 release, only the Direct Access option is supported for this API.
:::

## Available In

This API is available in the Salesforce platform.

## Prerequisites

- Required: CommsCloudTMFAPI or the CommsCloud platform license.
- The org must have the **CMERLMB2BAddon** or **CMERLMB2CAddon** license enabled.
- Optional: CommunicationsCloudTMFAPIAddOn-1 add-on license.
- Access check: `IndustriesComms.orgHasCommsTMFAPIAccess`.
- If you implement Apex extensibility hooks, annotate the custom Apex class with `@PermGuard('IndustriesComms.orgHasCommsTMFAPIAccess')`.

## Extensibility

This API uses the TMF extensibility framework. For an overview of the framework and the release when extensibility is available for each API, see [Extensibility for TMF APIs](/docs/industries/communications/guide/introduction_ext.md).

For extensibility features, see [Extensibility for TMF666 v5 Account Management](/docs/industries/communications/guide/TMF666\_extensibility.md).

## Sample Apex URL (Direct Access Method)

TMF666 v5 API uses the following URL format:

`{https://MyDomainLoginUrl}/services/data/{{version}}/connect/comms/accountmanagement/v5/billingAccount`.

## Use TMF666 v5 API

To access and use the TMF666 v5 API:

1. Authorize and use a connected app and an OAuth 2.0 authorization flow. See [Authorize Access](/docs/industries/communications/guide/authorization.md).
2. Trigger the API call. Refer to the preceding section for sample URL.
3. Use the TMF666 v5 API resources and endpoints.
   - See [TMF666 v5 Use Cases](/docs/industries/communications/guide/TMF666use-cases.md) for sample URLs and payloads.
   - See [TMF666 v5 Resource Mappings](/docs/industries/communications/guide/tmf666\_resource_mapping.md) for parameter descriptions.
4. Based on the requirements, extend TMF666 v5 API. See [Extensibility for TMF666 v5 Account Management](/docs/industries/communications/guide/TMF666\_extensibility.md).