POST api/negotiator/my/preferences/emailsignature

Allows you to upload a document for use as email signature Processes this negotiator API request. The parameter and response sections describe the data exchanged with the API.

Request Information

URI Parameters

None.

Body Parameters

Document details

DocumentSaveCommandDataContract

Name	Description	Type	Additional information
IsPublic	Indicates whether this item is public.	boolean	None.
NeedsApproval	Indicates whether needs approval is true.	boolean	None.
ExpiryDate	The expiry date, expressed as a date and time.	date	None.
StartDate	The start date, expressed as a date and time.	date	None.
DocumentPlaceholderType	The document placeholder type value.	EnumDataContract	None.
DocumentPlaceholderSourceType	The document placeholder source type value.	EnumDataContract	None.
IsGenerated	Indicates whether this item is generated.	boolean	None.
FileStream	The file stream value.	Stream	None.
Tags	The collection of tags.	Collection of TagDataContract	None.
ApprovalStatus	The approval status value.	DocumentApprovalDataContract	None.
DocumentType	The document type value.	EnumDataContract	None.
DocumentSubType	The document sub type value.	EnumDataContract	None.
FileName	The file name value.	string	None.
ContentType	The content type value.	string	None.
FileExtension	The file extension value.	string	None.
Description	The description value.	string	None.
FileSize	The file size value.	string	None.
CreatedDate	The created date, expressed as a date and time.	date	None.
CreatedBy	The created by value.	CreatedByDataContract	None.
Id	The unique identifier of this resource.	integer	None.

Request Formats

application/x-www-form-urlencoded

Sample:

Sample not available.

multipart/form-data

Sample:

Sample not available.

application/json, text/json

Sample:

{
  "IsPublic": true,
  "NeedsApproval": true,
  "ExpiryDate": "2026-07-23T08:24:19.366919Z",
  "StartDate": "2026-07-23T08:24:19.366919Z",
  "DocumentPlaceholderType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "DocumentPlaceholderSourceType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "IsGenerated": true,
  "FileStream": null,
  "Tags": [
    {
      "Name": "sample string 1",
      "SystemStatusName": "sample string 2",
      "TagType": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Id": 3
    },
    {
      "Name": "sample string 1",
      "SystemStatusName": "sample string 2",
      "TagType": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Id": 3
    }
  ],
  "ApprovalStatus": {
    "Status": {
      "Id": 1,
      "Name": "sample string 2",
      "SystemName": "sample string 3"
    },
    "Reason": "sample string 1",
    "LastUpdatedBy": {
      "Initials": "sample string 1",
      "ContactName": "sample string 2",
      "Gender": {
        "Id": 1,
        "Name": "sample string 2",
        "SystemName": "sample string 3"
      },
      "Title": "sample string 3",
      "FirstName": "sample string 4",
      "LastName": "sample string 5",
      "PrimaryTelephone": {
        "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
      },
      "PrimaryEmail": {
        "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
      },
      "JobTitle": "sample string 6",
      "Id": 7
    },
    "CreatedDate": "2026-07-23T08:24:19.366919Z",
    "LastUpdated": "2026-07-23T08:24:19.366919Z",
    "Id": 4
  },
  "DocumentType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "DocumentSubType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "FileName": "sample string 4",
  "ContentType": "sample string 5",
  "FileExtension": "sample string 6",
  "Description": "sample string 7",
  "FileSize": "sample string 8",
  "CreatedDate": "2026-07-23T08:24:19.366919Z",
  "CreatedBy": {
    "Initials": "sample string 1",
    "ContactName": "sample string 2",
    "Gender": {
      "Id": 1,
      "Name": "sample string 2",
      "SystemName": "sample string 3"
    },
    "Title": "sample string 3",
    "FirstName": "sample string 4",
    "LastName": "sample string 5",
    "PrimaryTelephone": {
      "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
    },
    "PrimaryEmail": {
      "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
    },
    "JobTitle": "sample string 6",
    "Id": 7
  },
  "Id": 10
}

Response Information

Resource Description

The response returned after the operation completes.

DocumentDataContract

Name	Description	Type	Additional information
Url	The url value.	string	None.
RequiresAuthentication	Indicates whether requires authentication is true.	boolean	None.
ExpiryDate	The expiry date, expressed as a date and time.	date	None.
Attachments	The collection of attachments.	Collection of DocumentDataContract	None.
ProcessedSuccessfully	Indicates whether processed successfully is true.	boolean	None.
ErrorMessage	The error message value.	string	None.
IsGenerated	Indicates whether this item is generated.	boolean	None.
Roles	The collection of roles.	Collection of DocumentRoleDataContract	None.
Properties	The collection of properties.	Collection of DocumentPropertyDataContract	None.
Groups	The collection of groups.	Collection of DocumentGroupDataContract	None.
FileStream	The file stream value.	Stream	None.
Tags	The collection of tags.	Collection of TagDataContract	None.
ApprovalStatus	The approval status value.	DocumentApprovalDataContract	None.
DocumentType	The document type value.	EnumDataContract	None.
DocumentSubType	The document sub type value.	EnumDataContract	None.
FileName	The file name value.	string	None.
ContentType	The content type value.	string	None.
FileExtension	The file extension value.	string	None.
Description	The description value.	string	None.
FileSize	The file size value.	string	None.
CreatedDate	The created date, expressed as a date and time.	date	None.
CreatedBy	The created by value.	CreatedByDataContract	None.
Id	The unique identifier of this resource.	integer	None.

Response Formats

application/json

Sample:

Sample not available.

text/json

Sample:

Sample not available.