Scope of Appointment (SOA) Insurance Book Slot (POST)

Book a follow-up appointment slot for a Scope of Appointment (SOA) insurance consultation with 48-hour compliance and agent prioritization.

Resource

1/connect/health/soa-insurance/book-slot

Available Version

67.0

HTTP Methods

POST

JSON example

1{
2  "accountId": "001xx000003DGb2AAG",
3  "engagementChannelTypeId": "0Hxxx0000000001",
4  "schedulingPolicyId": "0Hlxx0000000001",
5  "slotRangeEnd": "2026-09-01T12:00:00.000Z",
6  "slotRangeStart": "2026-09-01T10:00:00.000Z",
7  "soaId": "a0Xxx0000000001",
8  "territoryId": "0Hpxx0000000001",
9  "workTypeId": "08qxx0000000001"
10}

Properties

Property Name	Type	Description
`accountId`	String	Elderly customer Account identifier.
`engagementChannelTypeId`	List<String>	Appointment channel identifier (Phone, Video, etc.). Required only when AFA and Service Territory Member Shifts are enabled.
`schedulingPolicyId`	String	Lightning Scheduler Scheduling Policy identifier.
`slotRangeEnd`	String	Preferred booking window end time in ISO 8601 format. Must be later than slotRangeStart.
`slotRangeStart`	String	Preferred booking window start time in ISO 8601 format. Must be at least 48 hours in the future.
`soaId`	String	Salesforce Scope of Appointment (SOA) record identifier.
`territoryId`	List<String>	Service Territory identifier.
`workTypeId`	String	Salesforce Scheduler WorkType identifier.

Response Body for POST

Scope of Appointment (SOA) Insurance Book Slot Result