Hold Definition (POST)

Create a hold definition with hold reasons and a resolution plan.

Resource

1/connect/education/holds

Resource example

1https://yourInstance.salesforce.com/services/data/v64.0/connect/education/holds

Available version

64.0

HTTP methods

POST

Request body for POST

JSON example

1{
2  "name": "RestrictionName",
3  "subject": "string",
4  "description": "Updated description for academic probation hold.",
5  "regulatoryAuthorityId": "string",
6  "reasons": [
7    "0x6frr566",
8    "0x5674432",
9    "0x6frzz566"
10  ],
11  "resolution": {
12    "actionPlanTemplateVersionId": "0x4467778"
13  },
14  "type": "Academic",
15  "effectiveFrom": "2025-07-29",
16  "effectiveTo": "2025-07-29",
17  "canResolveAutomatically": true
18}

Properties

Name	Type	Description	Required or Optional	Available Version
`canResolveAutomatically`	Boolean	Indicates whether the restriction can be auto-resolved (`true`) or requires manual resolution (`true`).	Optional	64.0
`description`	String	Description of the hold.	Optional	64.0
`effectiveFrom`	String	Date from which the hold is effective.	Optional	64.0
`effectiveTo`	String	Date till which the hold is effective.	Optional	64.0
`name`	String	Name of the hold.	Optional	64.0
`reasons`	String[]	Reasons for the hold.	Optional	64.0
`regulatoryAuthorityId`	String	Unique ID of the regulatory authority.	Required	64.0
`resolution`	Action Plan Template Input	Unique ID of the action plan template associated with the resolution of this hold.	Required	64.0
`subject`	String	Subject of the hold.	Optional	64.0
`type`	String	Type of the hold.	Optional	64.0

Response body for POST

Hold Setup

Education Cloud Developer Guide

Hold Definition (POST)