Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Start Service Action

Initiate utility service by creating energy service agreements in an external billing system for specified service points and products.

This action is available in API version 60.0 and later.

Special Access Rules

The Start Service action is available in Enterprise and Unlimited Editions with Energy and Utilities Cloud.

Supported REST HTTP Methods

URI: /services/data/v60.0/actions/standard/startService
Formats: JSON, XML
HTTP Methods: POST
Authentication: Authorization: Bearer token

Inputs

Input	Details
accountId	Type string Description Required. ID of the account for which service is being started.
billingAccountId	Type string Description Required. ID of the billing account associated with the service.
premisesId	Type string Description Required. ID of the premises or location where service is started.
startDate	Type date Description Required. Date on which the service starts.
servicePointProductMapping	Type array[] Description Required. List of mappings between service points and the products associated with each service point. Maximum of 50 items.

Outputs

Output	Details
energyServiceAgreements	Type SObject array[] Description List of `EnergyServiceAgreement` records created by the action. Maximum of 50 items.

Example

POST

This sample request is for the Start Service action.

1{
2  "inputs": [
3    {
4      "accountId": "001xx000003DGb2AAG",
5      "billingAccountId": "15ixx0000004CjrAAE",
6      "premisesId": "131xx0000004CklAAE",
7      "startDate": "2026-07-01",
8      "servicePointProductMapping": [
9        {
10          "servicePointId": "0sSxx0000004CmqAAE",
11          "productId": "01txx0000006i8XAAU"
12        }
13      ]
14    }
15  ]
16}

This sample response is for the Start Service action.

1[
2  {
3    "actionName": "startService",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outputValues": {
8      "energyServiceAgreements": [
9        {
10          "Id": "a0Bxx0000004CmqAAE",
11          "Name": "ESA-00001234",
12          "AccountId": "001xx000003DGb2AAG",
13          "BillingAccountId": "15ixx0000004CjrAAE"
14        }
15      ]
16    },
17    "sortOrder": -1,
18    "version": 1
19  }
20]

Energy and Utilities Cloud Developer Guide