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": "5b73755a-ec3e-4bd0-b2e6-2b957cc7b4c5",
  "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-06-30T23:57:47Z",
    "FileType": "sample string 4",
    "FileExtension": "sample string 5",
    "FileName": "sample string 6",
    "Personal": true,
    "Shortcut": true
  },
  "IsPrivate": true,
  "ManageUserId": "1b01e682-7a79-4503-af7d-0fc0f11a3448",
  "EditDate": "2026-06-30T23:57:47Z",
  "CreateDate": "2026-06-30T23:57:47Z",
  "StartTime": "2026-06-30T23:57:47Z",
  "EndTime": "2026-06-30T23:57:47Z",
  "Details": "sample string 12",
  "LinkedEntities": {
    "Contacts": [
      "2a531012-7b02-4efb-a576-1db59b5932b9",
      "937e4ca4-7d98-4b54-9161-3c2c3faaf5db"
    ],
    "Companies": [
      "c5ab1042-ce8a-4b9c-8fdc-f41daf7bba28",
      "9123396d-15cb-4dce-a347-ebfbd9912352"
    ],
    "Groups": [
      "a5fb5c8b-2b1a-417c-8fcc-6428d6e3a981",
      "785645d4-77ca-478f-9f40-f8607f608ebb"
    ],
    "Opportunities": [
      "5f316e4e-ed87-417b-9ea4-4fc302124ef6",
      "68d6bd18-1fc7-4630-91f0-69dd9ee5c028"
    ]
  }
}

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:
"636d75f1-ef86-487b-8ac3-158fc02aa6a0"