Start Service Action | Energy and Utilities Cloud Developer Guide

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]