Create

Create

Create

Adds an appointment type to an account.

Request

Method
URL
POST
 https://api.solatech-dos.com/lists/v1/accounts/{accountUniqueId}/appointmenttypes 

Path Parameters

Name
Required
Type
Description
accountUniqueId

Guid
The unique ID of the account.

Headers

Name
Required
Type
Description
APIKey

Guid
A valid API key with a scope of AccountLists

Body

Name
Required
Type
Description
appointmentType

Text
The label of the appointment type. Must not be empty and must be 32 characters or fewer.
active
Boolean
Indicates if the appointment type is active or inactive. Defaults to true if omitted.
{
  "appointmentType": "In-Home Consultation",
  "active": true
}

Remarks

appointmentType is required, cannot be empty, and cannot exceed 32 characters. If active is omitted, the appointment type is created as active.
Appointment type labels must be unique per account. Attempting to create an appointment type with a label that already exists for the account will fail with a 409 conflict.

Response

Headers

Location — the URL of the newly created appointment type.

Status Code

Code
Description
201 Created
The appointment type was created.
400 Bad Request
The appointment type was not created. This occurs if appointmentType is missing, empty, or longer than 32 characters.
401 Unauthorized
The API key is missing, invalid, disabled, or does not have the correct scope.
403 Forbidden
The API key does not belong to this account, the account does not have the API keys feature enabled, or the key does not have the required scope.
409 Conflict
An appointment type with that label already exists for this account.

Body

Name
Type
Description
uniqueId
Guid
The unique ID of the appointment type.
appointmentType
Text
The label of the appointment type.
active
Boolean
Indicates if the appointment type is active or inactive.