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

Where TOKEN is a variable.

Inputs

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

Outputs

Output	Type	Description
`energyServiceAgreements`	SObject array[]	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]