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": "ccdc41e4-c983-469a-9d0a-963112e26018",
  "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-01-14T05:22:11Z",
    "FileType": "sample string 4",
    "FileExtension": "sample string 5",
    "FileName": "sample string 6",
    "Personal": true,
    "Shortcut": true
  },
  "IsPrivate": true,
  "ManageUserId": "b212789a-34a4-4596-9c05-f9fa484264a5",
  "EditDate": "2026-01-14T05:22:11Z",
  "CreateDate": "2026-01-14T05:22:11Z",
  "StartTime": "2026-01-14T05:22:11Z",
  "EndTime": "2026-01-14T05:22:11Z",
  "Details": "sample string 12",
  "LinkedEntities": {
    "Contacts": [
      "02d58974-cd59-4ee4-bd49-7847c30f568d",
      "0bb80a81-bcca-4176-a6af-7f8f4b445239"
    ],
    "Companies": [
      "81f3bc7a-99ff-48f4-9760-7d9b582474f2",
      "21fd2367-1d1b-41ac-871f-93f7f9195781"
    ],
    "Groups": [
      "85ea820c-3575-427b-9848-45fb6095450b",
      "11df26eb-6c6b-496f-8cf6-dd7c426b8f31"
    ],
    "Opportunities": [
      "e8bde229-6f5e-4b41-89b4-e6f1a36ace9d",
      "a42258ef-c7c2-43fb-a69b-c5cf5d4abeb0"
    ]
  }
}

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:
"ffd0620c-6a69-4d87-abaa-3dbb3554bdb9"