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": "4b3bc9e7-1ada-4075-ad28-55fd1cf8a743",
  "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-08-29T12:42:59Z",
    "FileType": "sample string 4",
    "FileExtension": "sample string 5",
    "FileName": "sample string 6",
    "Personal": true,
    "Shortcut": true
  },
  "IsPrivate": true,
  "ManageUserId": "1aaa5d28-371c-48aa-9605-e18e18fee99f",
  "EditDate": "2026-08-29T12:42:59Z",
  "CreateDate": "2026-08-29T12:42:59Z",
  "StartTime": "2026-08-29T12:42:59Z",
  "EndTime": "2026-08-29T12:42:59Z",
  "Details": "sample string 12",
  "LinkedEntities": {
    "Contacts": [
      "f1069045-db7c-4881-9d87-ee90fdba2c0e",
      "24710337-a32b-414b-8db3-5bd3a2d8a2ca"
    ],
    "Companies": [
      "c79441f6-6285-4650-b83a-2257c8d99390",
      "67762db2-44e0-41af-9581-ee32f6caa14c"
    ],
    "Groups": [
      "b53313b2-7fb1-4823-8de6-51b4e4d8e4df",
      "c7f0803f-f1f5-4ffa-9262-b4384aef05e2"
    ],
    "Opportunities": [
      "e766e601-f969-43f7-bf03-5593fcfd4eac",
      "dd0efa71-4362-4139-8abd-ee3bc43f8330"
    ]
  }
}

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:
"746cafb5-cf22-4789-b3cc-01f4a1a7449b"