---
schema_version: "1"
id: c8095c9cdb876f213ae414445594ebe4c792f5769c7ed85f7068009ca77f8728
title: Scope of Appointment (SOA) Insurance Book Slot (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/connect_resources_soa_insurance_book_slot.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_resources_soa_insurance_book_slot.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 11442377cf3de4686df4ed1eb4b25780b3c6e1424cccede5e526a3c775739122
description: Book a follow-up appointment slot for a Scope of Appointment (SOA) insurance consultation with 48-hour compliance and agent prioritization.
---
# 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

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

## Available Version

67.0

## HTTP Methods

POST

## JSON example

{
  "accountId": "001xx000003DGb2AAG",
  "engagementChannelTypeId": "0Hxxx0000000001",
  "schedulingPolicyId": "0Hlxx0000000001",
  "slotRangeEnd": "2026-09-01T12:00:00.000Z",
  "slotRangeStart": "2026-09-01T10:00:00.000Z",
  "soaId": "a0Xxx0000000001",
  "territoryId": "0Hpxx0000000001",
  "workTypeId": "08qxx0000000001"
}

## Properties

| Property Name | Type | Description |
| --- | --- | --- |
| account​Id | String | Elderly customer Account identifier. |
| engagement​Channel​Type​Id | List<String> | Appointment channel identifier (Phone, Video, etc.). Required only when AFA and Service Territory Member Shifts are enabled. |
| scheduling​Policy​Id | String | Lightning Scheduler Scheduling Policy identifier. |
| slot​Range​End | String | Preferred booking window end time in ISO 8601 format. Must be later than slotRangeStart. |
| slot​Range​Start | String | Preferred booking window start time in ISO 8601 format. Must be at least 48 hours in the future. |
| soa​Id | String | Salesforce Scope of Appointment (SOA) record identifier. |
| territory​Id | List<String> | Service Territory identifier. |
| work​Type​Id | String | Salesforce Scheduler WorkType identifier. |

## Response Body for POST

[Scope of Appointment (SOA) Insurance Book Slot Result](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_responses_soa_insurance_book_slot_result.htm "Scope of Appointment (SOA) insurance book slot result.")