Add Appointments Rescheduled History

Purpose

To add new records in the appointments rescheduled history.

Endpoints

Request Details

Request URL

{api-domain}/crm/{version}/Appointments_Rescheduled_History__s

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.modules.appointments_rescheduled_history.{operation_type}

Possible operation types

ALL - Full access to appointments rescheduled history data
CREATE - Create new records in appointments rescheduled history

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v3/Appointments_Rescheduled_History__s "
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Request JSON Keys

  • Appointment_NameJSON object, mandatory

    Contains the name and distinctive ID of the appointment for which you are creating the rescheduled history. You can obtain these details from GET Appointments API.

  • Rescheduled_Timestring, mandatory

    Represents the date and time at which the appointment was rescheduled. The value should be given in the ISO 8601 format.

  • Rescheduled_ByJSON object, mandatory

    Contains the name and ID of the user who rescheduled the appointment. You can fetch the user details by making a GET Users API call.

  • Rescheduled_Fromstring, mandatory

    Represents the date and time from which the appointment was recheduled. The value should be given in the ISO 8601 format.

  • Rescheduled_Tostring, mandatory

    Represents the date and time to which the appointment was rescheduled. The value should be given in the ISO 8601 fromat.

  • Reschedule_NoteString, optional

    Represents the reason for rescheduling the appointment.

  • Reschedule_ReasonString, optional

    Represents who was the reason for rescheduling the appointment.
    Possible Values: 'By Customer' and 'By Team'.

Sample Input

Copied{
    "data": [
        {
            "Rescheduled_From": "2023-05-02T09:30:00+05:30",
            "Rescheduled_To": "2023-05-02T10:30:00+05:30",
            "Appointment_Name": {
                "name": "AC Repair - James",
                "id": "5545974000002555001"
            },
            "Rescheduled_Time": "2023-05-02T11:00:46+05:30",
            "Rescheduled_By": {
                "name": "Patricia Boyle",
                "id": "5545974000000393001"
            },
            "Reschedule_Note": "Customer unavailable",
            "Reschedule_Reason": "By Customer"
        }
    ]
}
Note

  • You can create a maximum of 100 records per API call and only 20 rescheduled history records for a single appointment.

Possible Errors

  • INVALID_DATAHTTP 400

    You have specified an invalid ID either in the Rescheduled_By key or the Appointment_Name key.
    Solution: Make a GET Appointments API call to provide a valid rescheduled user and appointment ID.

  • INVALID_DATAHTTP 400

    The Rescheduled_Time key has a time greater than the current time.
    Solution: The Rescheduled_Time value should be lesser than the current time.

  • IN_REQUEST_LIMIT_EXCEEDEDHTTP 400

    You have tried to create more than 20 rescheduled history records for an appointment.
    Solution: Only 20 rescheduled history records can be created for an appointment using this API.

  • INVALID_MODULEHTTP 400

    You have given an invalid module name in the request URL.
    Solution: You can use only Appointments_Rescheduled_History__s in the request URL.

  • INVALID_REQUEST_METHODHTTP 400

    You have given an invalid http request method type.
    Solution: Use only the POST method in the request URL to access this API.

  • MANDATORY_NOT_FOUNDHTTP 400

    You have failed to specify any of the mandatory fields.
    Solution: The 'details' key in the error response will provide the missing mandatory field. You can also refer to the above Request JSON Keys section to find other mandatory fields.

  • INVALID_TOKENHTTP 401

    You have used an invalid oauth token.
    Solution: The access token you used has expired. Kindly refresh your token and retry.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    You created the grant token using the wrong oauth scope.
    Solution: Use either ZohoCRM.modules.appointments_rescheduled_history.CREATE or ZohoCRM.modules.appointments_rescheduled_history.ALL scope to create a new valid grant token.

  • NO_PERMISSIONHTTP 403

    You do not have permission to create any appointments rescheduled history records.
    Solution: Contact your system administrator.

  • NOT_ALLOWEDHTTP 403

    You have tried to make an entry without rescheduling the appointment.
    Solution: Any appointment must be rescheduled atleast once to add new rescheduled history records.

  • INVALID_URL_PATTERNHTTP 404

    Check if you are trying to access the correct URL.
    Solution: You have given an invalid request URL. Use only /Appointments_Rescheduled_History__s endpoint in the URL.

  • INTERNAL_ERRORHTTP 500

    Internal Server Error
    Solution: Unexpected and unhandled exception in the server. Please contact our support team.

Sample Response

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "Modified_Time": "2023-05-02T12:35:36+05:30",
                "Modified_By": {
                    "name": "Patricia Boyle",
                    "id": "5545974000000393001"
                },
                "Created_Time": "2023-05-02T12:35:36+05:30",
                "id": "5545974000002556034",
                "Created_By": {
                    "name": "Patricia Boyle",
                    "id": "5545974000000393001"
                },
                "$approval_state": "approved"
            },
            "message": "record added",
            "status": "success"
        }
    ]
}