POST api/Histories

Create a new History

Request Information

URI Parameters

None.

Body Parameters

History
NameDescriptionTypeAdditional information
Id

SQL Column Name: [HISTORYID]

globally unique identifier

None.

Regarding

SQL Column Name: [REGARDING]

string

None.

Duration

SQL Column Name: [DURATION]

string

None.

OutlookID

string

None.

HistoryTypeID

SQL Column Name: [HISTORYTYPEID]

integer

None.

HistoryType

HistoryType

None.

Attachment

Attachment

None.

IsPrivate

boolean

None.

ManageUserId

globally unique identifier

None.

EditDate

SQL Column Name: [EDIT_DATE]

date

None.

CreateDate

SQL Column Name: [CREATE_DATE]

date

None.

StartTime

SQL Column Name: [START_DATE_TIME]

date

None.

EndTime

SQL Column Name: [END_DATE_TIME]

date

None.

Details

SQL Column Name: [DETAILS]

string

None.

LinkedEntities

LinkedEntities

None.

Request Formats

application/json, text/json

Sample:
{
  "Id": "fca46d61-bcda-4906-b3c4-4bbeb69cdc47",
  "Regarding": "sample string 2",
  "Duration": "sample string 3",
  "OutlookID": "sample string 4",
  "HistoryTypeID": 5,
  "HistoryType": {
    "Name": "sample string 1",
    "HistoryTypeId": 2,
    "Description": "sample string 3",
    "ActivityTypeID": "sample string 4",
    "ActivityTypeName": "sample string 5",
    "IsActive": true,
    "IsCustom": true,
    "IsDefault": true,
    "IsUserRecordable": true
  },
  "Attachment": {
    "DisplayName": "sample string 1",
    "FileSize": 2.1,
    "LastModified": "2026-02-28T22:43:44Z",
    "FileType": "sample string 4",
    "FileExtension": "sample string 5",
    "FileName": "sample string 6",
    "Personal": true,
    "Shortcut": true
  },
  "IsPrivate": true,
  "ManageUserId": "b8e826a7-e9a1-4ad9-8482-8a7a46d16658",
  "EditDate": "2026-02-28T22:43:44Z",
  "CreateDate": "2026-02-28T22:43:44Z",
  "StartTime": "2026-02-28T22:43:44Z",
  "EndTime": "2026-02-28T22:43:44Z",
  "Details": "sample string 12",
  "LinkedEntities": {
    "Contacts": [
      "09c6639c-831f-4c9f-837b-713bc45c9dcc",
      "b37e265d-0110-4dc9-a189-37b405f4f2ce"
    ],
    "Companies": [
      "8e82a82e-7d38-4db5-8353-885c6e121a8a",
      "4a8e673d-31ab-4200-8347-0a51c09dc49d"
    ],
    "Groups": [
      "70dda86d-af04-412f-94de-eed0e7b0d14f",
      "fae7bb9d-a363-4bde-895d-e7d3320e2ed5"
    ],
    "Opportunities": [
      "0912e582-2530-4496-b2ef-7b56e502b7b1",
      "88a0f601-af69-49c4-a7a5-b5aa99dce1be"
    ]
  }
}

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Id of the new history record

globally unique identifier

Response Formats

application/json, text/json

Sample:
"3c26dbc0-5fb6-42cf-b6b7-cb0963842d74"