POST api/todo/general/savetodo

Saves or Updates a General ToDo This is currently used to save quick reminders Processes this general to do API request. The parameter and response sections describe the data exchanged with the API.

Request Information

URI Parameters

None.

Body Parameters

A wrapper for the todo save data and the various data contracts needed. You can update the following parameters: Title, Description, Negotiators.

SaveGeneralToDoCommandDataContract

Name	Description	Type	Additional information
PropertyMarketingRoleId	The unique identifier of the related property marketing role resource.	integer	None.
PeopleGroupId	The unique identifier of the related people group resource.	integer	None.
Id	The unique identifier of this resource.	integer	None.
ToDoOwner	The to do owner value.	integer	None.
Interval	The interval value.	EnumDataContract	None.
ScheduleType	The schedule type value.	EnumDataContract	None.
DueDate	The due date, expressed as a date and time.	date	None.
Title	The title value.	string	None.
Description	The description value.	string	None.
Priority	The priority value.	EnumDataContract	None.
NegotiatorIds	The unique identifiers of the related negotiator resources.	Collection of integer	None.

Request Formats

application/x-www-form-urlencoded

Sample:

Sample not available.

application/json, text/json

Sample:

{
  "PropertyMarketingRoleId": 1,
  "PeopleGroupId": 1,
  "Id": 1,
  "ToDoOwner": 1,
  "Interval": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "ScheduleType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "DueDate": "2026-07-23T08:17:43.1202463Z",
  "Title": "sample string 3",
  "Description": "sample string 4",
  "Priority": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "NegotiatorIds": [
    1,
    2
  ]
}

Response Information

Resource Description

The response returned after the operation completes.

ActiveToDoDataContract

Name	Description	Type	Additional information
ToDoOwner	The to do owner value.	NegotiatorTodoDataContract	None.
Interval	The interval value.	EnumDataContract	None.
Title	The title value.	string	None.
Description	The description value.	string	None.
Priority	The priority value.	EnumDataContract	None.
Negotiators	The collection of negotiators.	Collection of NegotiatorTodoDataContract	None.
Tasks	The collection of tasks.	Collection of TaskDetailsDataContract	None.
ToDoType	The to do type value.	EnumDataContract	None.
SuggestedSchedule	The suggested schedule value.	EnumDataContract	None.
EventType	The event type value.	EnumDataContract	None.
Id	The unique identifier of this resource.	integer	None.

Response Formats

application/json, text/json

Sample:

{
  "ToDoOwner": {
    "Email": {
      "Type": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Value": "sample string 1",
      "Notes": "sample string 2",
      "ContactOrder": 3,
      "AllowContact": true,
      "MarketingContactStatus": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Name": "sample string 5",
      "Id": 6
    },
    "ContactName": "sample string 1",
    "FirstName": "sample string 2",
    "LastName": "sample string 3",
    "Id": 4
  },
  "Interval": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "Title": "sample string 1",
  "Description": "sample string 2",
  "Priority": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "Negotiators": [
    {
      "Email": {
        "Type": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Value": "sample string 1",
        "Notes": "sample string 2",
        "ContactOrder": 3,
        "AllowContact": true,
        "MarketingContactStatus": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Name": "sample string 5",
        "Id": 6
      },
      "ContactName": "sample string 1",
      "FirstName": "sample string 2",
      "LastName": "sample string 3",
      "Id": 4
    },
    {
      "Email": {
        "Type": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Value": "sample string 1",
        "Notes": "sample string 2",
        "ContactOrder": 3,
        "AllowContact": true,
        "MarketingContactStatus": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Name": "sample string 5",
        "Id": 6
      },
      "ContactName": "sample string 1",
      "FirstName": "sample string 2",
      "LastName": "sample string 3",
      "Id": 4
    }
  ],
  "Tasks": [
    {
      "Id": 1,
      "DueDate": "2026-07-23T08:17:43.1358746Z",
      "StatusType": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "ScheduleType": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Event": {
        "Name": "sample string 1",
        "Description": "sample string 2",
        "DateTime": "2026-07-23T08:17:43.1358746Z",
        "EventCategory": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "EventType": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "EventStatus": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Id": 4
      },
      "TeamIds": [
        1,
        2
      ],
      "SearchTerms": [
        "sample string 1",
        "sample string 2"
      ]
    },
    {
      "Id": 1,
      "DueDate": "2026-07-23T08:17:43.1358746Z",
      "StatusType": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "ScheduleType": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Event": {
        "Name": "sample string 1",
        "Description": "sample string 2",
        "DateTime": "2026-07-23T08:17:43.1358746Z",
        "EventCategory": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "EventType": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "EventStatus": {
          "Id": 1,
          "Name": "sample string 2",
          "SystemName": "sample string 3"
        },
        "Id": 4
      },
      "TeamIds": [
        1,
        2
      ],
      "SearchTerms": [
        "sample string 1",
        "sample string 2"
      ]
    }
  ],
  "ToDoType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "SuggestedSchedule": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "EventType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "Id": 3
}