CurrenciesGetAllSupportedResponse
{
"type": "object",
"title": "getCurrenciesResponse200",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the currency"
},
"code": {
"type": "string",
"description": "The code of the currency"
},
"name": {
"type": "string",
"description": "The name of the currency"
},
"symbol": {
"type": "string",
"description": "The symbol of the currency"
},
"active_flag": {
"type": "boolean",
"description": "Whether the currency is active or not"
},
"decimal_points": {
"type": "integer",
"description": "The amount of decimal points of the currency"
},
"is_custom_flag": {
"type": "boolean",
"description": "Whether the currency is a custom one or not"
}
}
},
"description": "The array of currencies"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealFieldsAddNewFieldRequest
{
"allOf": [
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the field"
},
"options": {
"type": "array",
"items": {
"type": "object"
},
"description": "When `field_type` is either set or enum, possible options must be supplied as a JSON-encoded sequential array of objects. Example: `[{\"label\":\"New Item\"}]`"
},
"add_visible_flag": {
"type": "boolean",
"default": true,
"description": "Whether the field is available in the 'add new' modal or not (both in the web and mobile app)"
}
}
},
{
"type": "object",
"required": [
"field_type"
],
"properties": {
"field_type": {
"enum": [
"address",
"date",
"daterange",
"double",
"enum",
"monetary",
"org",
"people",
"phone",
"set",
"text",
"time",
"timerange",
"user",
"varchar",
"varchar_auto",
"visible_to"
],
"type": "string",
"description": "The type of the field<table><tr><th>Value</th><th>Description</th></tr><tr><td>`address`</td><td>Address field (has multiple subfields, autocompleted by Google Maps)</td></tr><tr><td>`date`</td><td>Date (format YYYY-MM-DD)</td></tr><tr><td>`daterange`</td><td>Date-range field (has a start date and end date value, both YYYY-MM-DD)</td></tr><tr><td>`double`</td><td>Numeric value</td></tr><tr><td>`enum`</td><td>Options field with a single possible chosen option</td></tr><tr></tr><tr><td>`monetary`</td><td>Monetary field (has a numeric value and a currency value)</td></tr><tr><td>`org`</td><td>Organization field (contains an organization ID which is stored on the same account)</td></tr><tr><td>`people`</td><td>Person field (contains a person ID which is stored on the same account)</td></tr><tr><td>`phone`</td><td>Phone field (up to 255 numbers and/or characters)</td></tr><tr><td>`set`</td><td>Options field with a possibility of having multiple chosen options</td></tr><tr><td>`text`</td><td>Long text (up to 65k characters)</td></tr><tr><td>`time`</td><td>Time field (format HH:MM:SS)</td></tr><tr><td>`timerange`</td><td>Time-range field (has a start time and end time value, both HH:MM:SS)</td></tr><tr><td>`user`</td><td>User field (contains a user ID of another Pipedrive user)</td></tr><tr><td>`varchar`</td><td>Text (up to 255 characters)</td></tr><tr><td>`varchar_auto`</td><td>Autocomplete text (up to 255 characters)</td></tr><tr><td>`visible_to`</td><td>System field that keeps item's visibility setting</td></tr></table>"
}
}
}
],
"title": "createFieldRequest"
}
DealFieldsAddNewFieldResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the field. Value is `null` in case of subfields."
},
"key": {
"type": "string",
"description": "The key of the field. For custom fields this is generated upon creation."
},
"name": {
"type": "string",
"description": "The name of the field"
},
"options": {
"type": "array",
"items": {
"type": "object"
},
"nullable": true,
"description": "The options of the field. When there are no options, `null` is returned."
},
"add_time": {
"type": "string",
"format": "date-time",
"description": "The creation time of the field"
},
"order_nr": {
"type": "integer",
"description": "The order number of the field"
},
"edit_flag": {
"type": "boolean",
"description": "The edit flag of the field"
},
"subfields": {
"type": "array",
"items": {
"type": "object"
},
"description": "The subfields of the field. Only present when the field has subfields."
},
"field_type": {
"allOf": [
{
"enum": [
"address",
"date",
"daterange",
"double",
"enum",
"monetary",
"org",
"people",
"phone",
"set",
"text",
"time",
"timerange",
"user",
"varchar",
"varchar_auto",
"visible_to"
],
"type": "string",
"description": "The type of the field<table><tr><th>Value</th><th>Description</th></tr><tr><td>`address`</td><td>Address field (has multiple subfields, autocompleted by Google Maps)</td></tr><tr><td>`date`</td><td>Date (format YYYY-MM-DD)</td></tr><tr><td>`daterange`</td><td>Date-range field (has a start date and end date value, both YYYY-MM-DD)</td></tr><tr><td>`double`</td><td>Numeric value</td></tr><tr><td>`enum`</td><td>Options field with a single possible chosen option</td></tr><tr></tr><tr><td>`monetary`</td><td>Monetary field (has a numeric value and a currency value)</td></tr><tr><td>`org`</td><td>Organization field (contains an organization ID which is stored on the same account)</td></tr><tr><td>`people`</td><td>Person field (contains a person ID which is stored on the same account)</td></tr><tr><td>`phone`</td><td>Phone field (up to 255 numbers and/or characters)</td></tr><tr><td>`set`</td><td>Options field with a possibility of having multiple chosen options</td></tr><tr><td>`text`</td><td>Long text (up to 65k characters)</td></tr><tr><td>`time`</td><td>Time field (format HH:MM:SS)</td></tr><tr><td>`timerange`</td><td>Time-range field (has a start time and end time value, both HH:MM:SS)</td></tr><tr><td>`user`</td><td>User field (contains a user ID of another Pipedrive user)</td></tr><tr><td>`varchar`</td><td>Text (up to 255 characters)</td></tr><tr><td>`varchar_auto`</td><td>Autocomplete text (up to 255 characters)</td></tr><tr><td>`visible_to`</td><td>System field that keeps item's visibility setting</td></tr></table>"
}
]
},
"active_flag": {
"type": "boolean",
"description": "The active flag of the field"
},
"is_subfield": {
"type": "boolean",
"description": "Whether or not the field is a subfield of another field. Only present if field is subfield."
},
"update_time": {
"type": "string",
"format": "date-time",
"description": "The update time of the field"
},
"sortable_flag": {
"type": "boolean",
"description": "Whether or not items can be sorted by this field"
},
"important_flag": {
"type": "boolean",
"description": "Not used"
},
"mandatory_flag": {
"type": "boolean",
"description": "Whether or not the field is mandatory"
},
"options_deleted": {
"type": "array",
"items": {
"type": "object"
},
"description": "The deleted options of the field. Only present when there is at least 1 deleted option."
},
"searchable_flag": {
"type": "boolean",
"description": "Whether or not items can be searched by this field"
},
"add_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"bulk_edit_allowed": {
"type": "boolean",
"description": "Whether or not the field of an item can be edited in bulk"
},
"filtering_allowed": {
"type": "boolean",
"description": "Whether or not items can be filtered by this field"
},
"index_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"details_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"last_updated_by_user_id": {
"type": "integer",
"description": "The ID of the user who created or most recently updated the field, only applicable for custom fields"
}
}
}
}
}
],
"title": "fieldResponse200"
}
DealFieldsDeleteMultipleBulkResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "array",
"items": {
"type": "integer"
},
"description": "The list of deleted field IDs"
}
}
}
}
}
],
"title": "deleteFieldsResponse200"
}
DealFieldsGetAllFieldsResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the field. Value is `null` in case of subfields."
},
"key": {
"type": "string",
"description": "The key of the field. For custom fields this is generated upon creation."
},
"name": {
"type": "string",
"description": "The name of the field"
},
"options": {
"type": "array",
"items": {
"type": "object"
},
"nullable": true,
"description": "The options of the field. When there are no options, `null` is returned."
},
"add_time": {
"type": "string",
"format": "date-time",
"description": "The creation time of the field"
},
"order_nr": {
"type": "integer",
"description": "The order number of the field"
},
"edit_flag": {
"type": "boolean",
"description": "The edit flag of the field"
},
"subfields": {
"type": "array",
"items": {
"type": "object"
},
"description": "The subfields of the field. Only present when the field has subfields."
},
"field_type": {
"allOf": [
{
"enum": [
"address",
"date",
"daterange",
"double",
"enum",
"monetary",
"org",
"people",
"phone",
"set",
"text",
"time",
"timerange",
"user",
"varchar",
"varchar_auto",
"visible_to"
],
"type": "string",
"description": "The type of the field<table><tr><th>Value</th><th>Description</th></tr><tr><td>`address`</td><td>Address field (has multiple subfields, autocompleted by Google Maps)</td></tr><tr><td>`date`</td><td>Date (format YYYY-MM-DD)</td></tr><tr><td>`daterange`</td><td>Date-range field (has a start date and end date value, both YYYY-MM-DD)</td></tr><tr><td>`double`</td><td>Numeric value</td></tr><tr><td>`enum`</td><td>Options field with a single possible chosen option</td></tr><tr></tr><tr><td>`monetary`</td><td>Monetary field (has a numeric value and a currency value)</td></tr><tr><td>`org`</td><td>Organization field (contains an organization ID which is stored on the same account)</td></tr><tr><td>`people`</td><td>Person field (contains a person ID which is stored on the same account)</td></tr><tr><td>`phone`</td><td>Phone field (up to 255 numbers and/or characters)</td></tr><tr><td>`set`</td><td>Options field with a possibility of having multiple chosen options</td></tr><tr><td>`text`</td><td>Long text (up to 65k characters)</td></tr><tr><td>`time`</td><td>Time field (format HH:MM:SS)</td></tr><tr><td>`timerange`</td><td>Time-range field (has a start time and end time value, both HH:MM:SS)</td></tr><tr><td>`user`</td><td>User field (contains a user ID of another Pipedrive user)</td></tr><tr><td>`varchar`</td><td>Text (up to 255 characters)</td></tr><tr><td>`varchar_auto`</td><td>Autocomplete text (up to 255 characters)</td></tr><tr><td>`visible_to`</td><td>System field that keeps item's visibility setting</td></tr></table>"
}
]
},
"active_flag": {
"type": "boolean",
"description": "The active flag of the field"
},
"is_subfield": {
"type": "boolean",
"description": "Whether or not the field is a subfield of another field. Only present if field is subfield."
},
"update_time": {
"type": "string",
"format": "date-time",
"description": "The update time of the field"
},
"sortable_flag": {
"type": "boolean",
"description": "Whether or not items can be sorted by this field"
},
"important_flag": {
"type": "boolean",
"description": "Not used"
},
"mandatory_flag": {
"type": "boolean",
"description": "Whether or not the field is mandatory"
},
"options_deleted": {
"type": "array",
"items": {
"type": "object"
},
"description": "The deleted options of the field. Only present when there is at least 1 deleted option."
},
"searchable_flag": {
"type": "boolean",
"description": "Whether or not items can be searched by this field"
},
"add_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"bulk_edit_allowed": {
"type": "boolean",
"description": "Whether or not the field of an item can be edited in bulk"
},
"filtering_allowed": {
"type": "boolean",
"description": "Whether or not items can be filtered by this field"
},
"index_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"details_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"last_updated_by_user_id": {
"type": "integer",
"description": "The ID of the user who created or most recently updated the field, only applicable for custom fields"
}
}
}
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
}
}
}
],
"title": "fieldsResponse200"
}
DealFieldsGetOneFieldResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the field. Value is `null` in case of subfields."
},
"key": {
"type": "string",
"description": "The key of the field. For custom fields this is generated upon creation."
},
"name": {
"type": "string",
"description": "The name of the field"
},
"options": {
"type": "array",
"items": {
"type": "object"
},
"nullable": true,
"description": "The options of the field. When there are no options, `null` is returned."
},
"add_time": {
"type": "string",
"format": "date-time",
"description": "The creation time of the field"
},
"order_nr": {
"type": "integer",
"description": "The order number of the field"
},
"edit_flag": {
"type": "boolean",
"description": "The edit flag of the field"
},
"subfields": {
"type": "array",
"items": {
"type": "object"
},
"description": "The subfields of the field. Only present when the field has subfields."
},
"field_type": {
"allOf": [
{
"enum": [
"address",
"date",
"daterange",
"double",
"enum",
"monetary",
"org",
"people",
"phone",
"set",
"text",
"time",
"timerange",
"user",
"varchar",
"varchar_auto",
"visible_to"
],
"type": "string",
"description": "The type of the field<table><tr><th>Value</th><th>Description</th></tr><tr><td>`address`</td><td>Address field (has multiple subfields, autocompleted by Google Maps)</td></tr><tr><td>`date`</td><td>Date (format YYYY-MM-DD)</td></tr><tr><td>`daterange`</td><td>Date-range field (has a start date and end date value, both YYYY-MM-DD)</td></tr><tr><td>`double`</td><td>Numeric value</td></tr><tr><td>`enum`</td><td>Options field with a single possible chosen option</td></tr><tr></tr><tr><td>`monetary`</td><td>Monetary field (has a numeric value and a currency value)</td></tr><tr><td>`org`</td><td>Organization field (contains an organization ID which is stored on the same account)</td></tr><tr><td>`people`</td><td>Person field (contains a person ID which is stored on the same account)</td></tr><tr><td>`phone`</td><td>Phone field (up to 255 numbers and/or characters)</td></tr><tr><td>`set`</td><td>Options field with a possibility of having multiple chosen options</td></tr><tr><td>`text`</td><td>Long text (up to 65k characters)</td></tr><tr><td>`time`</td><td>Time field (format HH:MM:SS)</td></tr><tr><td>`timerange`</td><td>Time-range field (has a start time and end time value, both HH:MM:SS)</td></tr><tr><td>`user`</td><td>User field (contains a user ID of another Pipedrive user)</td></tr><tr><td>`varchar`</td><td>Text (up to 255 characters)</td></tr><tr><td>`varchar_auto`</td><td>Autocomplete text (up to 255 characters)</td></tr><tr><td>`visible_to`</td><td>System field that keeps item's visibility setting</td></tr></table>"
}
]
},
"active_flag": {
"type": "boolean",
"description": "The active flag of the field"
},
"is_subfield": {
"type": "boolean",
"description": "Whether or not the field is a subfield of another field. Only present if field is subfield."
},
"update_time": {
"type": "string",
"format": "date-time",
"description": "The update time of the field"
},
"sortable_flag": {
"type": "boolean",
"description": "Whether or not items can be sorted by this field"
},
"important_flag": {
"type": "boolean",
"description": "Not used"
},
"mandatory_flag": {
"type": "boolean",
"description": "Whether or not the field is mandatory"
},
"options_deleted": {
"type": "array",
"items": {
"type": "object"
},
"description": "The deleted options of the field. Only present when there is at least 1 deleted option."
},
"searchable_flag": {
"type": "boolean",
"description": "Whether or not items can be searched by this field"
},
"add_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"bulk_edit_allowed": {
"type": "boolean",
"description": "Whether or not the field of an item can be edited in bulk"
},
"filtering_allowed": {
"type": "boolean",
"description": "Whether or not items can be filtered by this field"
},
"index_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"details_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"last_updated_by_user_id": {
"type": "integer",
"description": "The ID of the user who created or most recently updated the field, only applicable for custom fields"
}
}
}
}
}
],
"title": "fieldResponse200"
}
DealFieldsMarkAsDeletedResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the field that was deleted"
}
}
}
}
}
],
"title": "deleteFieldResponse200"
}
DealFieldsUpdateFieldRequest
{
"type": "object",
"title": "updateFieldRequest",
"properties": {
"name": {
"type": "string",
"description": "The name of the field"
},
"options": {
"type": "array",
"items": {
"type": "object"
},
"description": "When `field_type` is either set or enum, possible options must be supplied as a JSON-encoded sequential array of objects. All active items must be supplied and already existing items must have their ID supplied. New items only require a label. Example: `[{\"id\":123,\"label\":\"Existing Item\"},{\"label\":\"New Item\"}]`"
},
"add_visible_flag": {
"type": "boolean",
"default": true,
"description": "Whether the field is available in 'add new' modal or not (both in web and mobile app)"
}
}
}
DealFieldsUpdateFieldResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the field. Value is `null` in case of subfields."
},
"key": {
"type": "string",
"description": "The key of the field. For custom fields this is generated upon creation."
},
"name": {
"type": "string",
"description": "The name of the field"
},
"options": {
"type": "array",
"items": {
"type": "object"
},
"nullable": true,
"description": "The options of the field. When there are no options, `null` is returned."
},
"add_time": {
"type": "string",
"format": "date-time",
"description": "The creation time of the field"
},
"order_nr": {
"type": "integer",
"description": "The order number of the field"
},
"edit_flag": {
"type": "boolean",
"description": "The edit flag of the field"
},
"subfields": {
"type": "array",
"items": {
"type": "object"
},
"description": "The subfields of the field. Only present when the field has subfields."
},
"field_type": {
"allOf": [
{
"enum": [
"address",
"date",
"daterange",
"double",
"enum",
"monetary",
"org",
"people",
"phone",
"set",
"text",
"time",
"timerange",
"user",
"varchar",
"varchar_auto",
"visible_to"
],
"type": "string",
"description": "The type of the field<table><tr><th>Value</th><th>Description</th></tr><tr><td>`address`</td><td>Address field (has multiple subfields, autocompleted by Google Maps)</td></tr><tr><td>`date`</td><td>Date (format YYYY-MM-DD)</td></tr><tr><td>`daterange`</td><td>Date-range field (has a start date and end date value, both YYYY-MM-DD)</td></tr><tr><td>`double`</td><td>Numeric value</td></tr><tr><td>`enum`</td><td>Options field with a single possible chosen option</td></tr><tr></tr><tr><td>`monetary`</td><td>Monetary field (has a numeric value and a currency value)</td></tr><tr><td>`org`</td><td>Organization field (contains an organization ID which is stored on the same account)</td></tr><tr><td>`people`</td><td>Person field (contains a person ID which is stored on the same account)</td></tr><tr><td>`phone`</td><td>Phone field (up to 255 numbers and/or characters)</td></tr><tr><td>`set`</td><td>Options field with a possibility of having multiple chosen options</td></tr><tr><td>`text`</td><td>Long text (up to 65k characters)</td></tr><tr><td>`time`</td><td>Time field (format HH:MM:SS)</td></tr><tr><td>`timerange`</td><td>Time-range field (has a start time and end time value, both HH:MM:SS)</td></tr><tr><td>`user`</td><td>User field (contains a user ID of another Pipedrive user)</td></tr><tr><td>`varchar`</td><td>Text (up to 255 characters)</td></tr><tr><td>`varchar_auto`</td><td>Autocomplete text (up to 255 characters)</td></tr><tr><td>`visible_to`</td><td>System field that keeps item's visibility setting</td></tr></table>"
}
]
},
"active_flag": {
"type": "boolean",
"description": "The active flag of the field"
},
"is_subfield": {
"type": "boolean",
"description": "Whether or not the field is a subfield of another field. Only present if field is subfield."
},
"update_time": {
"type": "string",
"format": "date-time",
"description": "The update time of the field"
},
"sortable_flag": {
"type": "boolean",
"description": "Whether or not items can be sorted by this field"
},
"important_flag": {
"type": "boolean",
"description": "Not used"
},
"mandatory_flag": {
"type": "boolean",
"description": "Whether or not the field is mandatory"
},
"options_deleted": {
"type": "array",
"items": {
"type": "object"
},
"description": "The deleted options of the field. Only present when there is at least 1 deleted option."
},
"searchable_flag": {
"type": "boolean",
"description": "Whether or not items can be searched by this field"
},
"add_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"bulk_edit_allowed": {
"type": "boolean",
"description": "Whether or not the field of an item can be edited in bulk"
},
"filtering_allowed": {
"type": "boolean",
"description": "Whether or not items can be filtered by this field"
},
"index_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"details_visible_flag": {
"type": "boolean",
"description": "Not used"
},
"last_updated_by_user_id": {
"type": "integer",
"description": "The ID of the user who created or most recently updated the field, only applicable for custom fields"
}
}
}
}
}
],
"title": "fieldResponse200"
}
DealsAddFollowerRequest
{
"type": "object",
"title": "addDealFollowerRequest",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "integer",
"description": "The ID of the user"
}
}
}
DealsAddFollowerResponse
{
"type": "object",
"title": "addDealFollowerResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The follower ID"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal which the follower was added to"
},
"user_id": {
"type": "integer",
"description": "The user ID who added the follower"
},
"add_time": {
"type": "string",
"description": "The date and time when the deal follower was added"
}
}
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsAddParticipantRequest
{
"type": "object",
"title": "addDealParticipantRequest",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "integer",
"description": "The ID of the person"
}
}
}
DealsAddParticipantResponse
{
"type": "object",
"title": "addDealParticipantResponse200",
"properties": {
"data": {
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The label that indicates the type of the email. (Possible values - work, home or other)"
},
"value": {
"type": "string",
"description": "Email"
},
"primary": {
"type": "boolean",
"description": "Boolean that indicates if email is primary for the person or not"
}
}
},
"description": "An email address as a string or an array of email objects related to the person. The structure of the array is as follows: `[{ \"value\": \"mail@example.com\", \"primary\": \"true\", \"label\": \"main\" } ]`. Please note that only `value` is required."
},
"label": {
"type": "integer",
"description": "The label assigned to the person"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The label that indicates the type of the phone number. (Possible values - work, home, mobile or other)"
},
"value": {
"type": "string",
"description": "The phone number"
},
"primary": {
"type": "boolean",
"description": "Boolean that indicates if phone number is primary for the person or not"
}
}
},
"description": "A phone number supplied as a string or an array of phone objects related to the person. The structure of the array is as follows: `[{ \"value\": \"12345\", \"primary\": \"true\", \"label\": \"mobile\" }]`. Please note that only `value` is required."
},
"add_time": {
"type": "string",
"description": "The date and time when the person was added/created. Format: YYYY-MM-DD HH:MM:SS"
},
"cc_email": {
"type": "string",
"description": "The BCC email associated with the person"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the person"
},
"company_id": {
"type": "integer",
"description": "The ID of the company related to the person"
},
"first_char": {
"type": "string",
"description": "The first letter of the name of the person"
},
"owner_name": {
"type": "string",
"description": "The name of the owner associated with the person"
},
"picture_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the picture associated with the item"
}
}
},
{
"type": "object",
"properties": {
"item_id": {
"type": "integer",
"description": "The ID of related item"
},
"add_time": {
"type": "string",
"description": "The add time of the picture"
},
"pictures": {
"type": "object",
"properties": {
"128": {
"type": "string",
"description": "The URL of the 128*128 picture"
},
"512": {
"type": "string",
"description": "The URL of the 512*512 picture"
}
}
},
"item_type": {
"type": "string",
"description": "The type of item the picture is related to"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated picture is active or not"
},
"update_time": {
"type": "string",
"description": "The update time of the picture"
},
"added_by_user_id": {
"type": "integer",
"description": "The ID of the user who added the picture"
}
}
}
]
},
"visible_to": {
"type": "string",
"description": "The visibility group ID of who can see the person"
},
"active_flag": {
"type": "boolean",
"description": "Whether the person is active or not"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the person. Format: YYYY-MM-DD HH:MM:SS"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"org_id": {
"allOf": [
{
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization"
}
}
}
],
"title": "relationshipOrganizationInfoItem"
},
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
}
],
"title": "relationshipOrganizationInfoItemWithActiveFlag"
},
"owner_id": {
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the owner"
}
}
}
],
"title": "owner"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person"
},
"last_name": {
"type": "string",
"description": "The last name of the person"
},
"first_name": {
"type": "string",
"description": "The first name of the person"
}
}
}
],
"title": "personNameInfoWithOrgAndOwnerId"
},
{
"type": "object",
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"files_count": {
"type": "integer",
"description": "The count of files related to the person"
},
"notes_count": {
"type": "integer",
"description": "The count of notes related to the person"
},
"followers_count": {
"type": "integer",
"description": "The count of followers related to the person"
},
"activities_count": {
"type": "integer",
"description": "The count of activities related to the person"
},
"email_messages_count": {
"type": "integer",
"description": "The count of email messages related to the person"
},
"done_activities_count": {
"type": "integer",
"description": "The count of done activities related to the person"
},
"undone_activities_count": {
"type": "integer",
"description": "The count of undone activities related to the person"
}
}
},
{
"type": "object",
"properties": {
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the person"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the person"
}
}
}
],
"title": "personCountAndEmailInfo"
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"won_deals_count": {
"type": "integer",
"description": "The count of won deals related with the item"
},
"lost_deals_count": {
"type": "integer",
"description": "The count of lost deals related with the item"
},
"open_deals_count": {
"type": "integer",
"description": "The count of open deals related with the item"
},
"closed_deals_count": {
"type": "integer",
"description": "The count of closed deals related with the item"
},
"related_won_deals_count": {
"type": "integer",
"description": "The count of related won deals related with the item"
},
"related_lost_deals_count": {
"type": "integer",
"description": "The count of related lost deals related with the item"
},
"related_open_deals_count": {
"type": "integer",
"description": "The count of related open deals related with the item"
},
"related_closed_deals_count": {
"type": "integer",
"description": "The count of related closed deals related with the item"
}
}
},
{
"type": "object",
"properties": {
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"nullable": true,
"description": "The time of the next activity associated with the deal"
}
}
}
],
"title": "dealCountAndActivityInfo"
}
],
"title": "personCountEmailDealAndActivityInfo"
}
],
"title": "additionalPersonInfo"
}
],
"title": "personItem"
}
],
"description": "The object of participant"
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
}
}
}
}
}
DealsAddProductToDealRequest
{
"allOf": [
{
"type": "object",
"title": "basicDealProductRequest",
"required": [
"product_id",
"item_price",
"quantity"
],
"properties": {
"tax": {
"type": "number",
"default": 0,
"description": "The tax percentage"
},
"comments": {
"type": "string",
"description": "A textual comment associated with this product-deal attachment"
},
"discount": {
"type": "number",
"default": 0,
"description": "The value of the discount. The `discount_type` field can be used to specify whether the value is an amount or a percentage."
},
"duration": {
"type": "number",
"default": 1,
"description": "The duration of the product. If omitted, will be set to 1."
},
"quantity": {
"type": "integer",
"description": "Quantity – e.g. how many items of this product will be added to the deal"
},
"item_price": {
"type": "number",
"description": "The price at which this product will be added to the deal"
},
"product_id": {
"type": "integer",
"description": "The ID of the product to use"
},
"tax_method": {
"enum": [
"exclusive",
"inclusive",
"none"
],
"type": "string",
"description": "The tax option to be applied to the products. When using `inclusive`, the tax percentage will already be included in the price. When using `exclusive`, the tax will not be included in the price. When using `none`, no tax will be added. Use the `tax` field for defining the tax percentage amount. By default, the user setting value for tax options will be used. Changing this in one product affects the rest of the products attached to the deal."
},
"enabled_flag": {
"type": "boolean",
"default": true,
"description": "Whether the product is enabled for a deal or not. This makes it possible to add products to a deal with a specific price and discount criteria, but keep them disabled, which refrains them from being included in the deal value calculation. When omitted, the product will be marked as enabled by default."
},
"discount_type": {
"enum": [
"percentage",
"amount"
],
"type": "string",
"default": "percentage",
"description": "The type of the discount's value."
},
"duration_unit": {
"type": "string",
"allOf": [
{
"enum": [
"hourly",
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string",
"title": "dealProductUnitDuration"
}
],
"description": "The unit duration of the product"
},
"product_variation_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the product variation to use. When omitted, no variation will be used."
}
}
}
],
"title": "addDealProductRequest"
}
DealsAddProductToDealResponse
{
"type": "object",
"title": "getAddProductAttachementResponse200",
"properties": {
"data": {
"allOf": [
{
"allOf": [
{
"allOf": [
{
"type": "object",
"title": "basicDealProductRequest",
"required": [
"product_id",
"item_price",
"quantity"
],
"properties": {
"tax": {
"type": "number",
"default": 0,
"description": "The tax percentage"
},
"comments": {
"type": "string",
"description": "A textual comment associated with this product-deal attachment"
},
"discount": {
"type": "number",
"default": 0,
"description": "The value of the discount. The `discount_type` field can be used to specify whether the value is an amount or a percentage."
},
"duration": {
"type": "number",
"default": 1,
"description": "The duration of the product. If omitted, will be set to 1."
},
"quantity": {
"type": "integer",
"description": "Quantity – e.g. how many items of this product will be added to the deal"
},
"item_price": {
"type": "number",
"description": "The price at which this product will be added to the deal"
},
"product_id": {
"type": "integer",
"description": "The ID of the product to use"
},
"tax_method": {
"enum": [
"exclusive",
"inclusive",
"none"
],
"type": "string",
"description": "The tax option to be applied to the products. When using `inclusive`, the tax percentage will already be included in the price. When using `exclusive`, the tax will not be included in the price. When using `none`, no tax will be added. Use the `tax` field for defining the tax percentage amount. By default, the user setting value for tax options will be used. Changing this in one product affects the rest of the products attached to the deal."
},
"enabled_flag": {
"type": "boolean",
"default": true,
"description": "Whether the product is enabled for a deal or not. This makes it possible to add products to a deal with a specific price and discount criteria, but keep them disabled, which refrains them from being included in the deal value calculation. When omitted, the product will be marked as enabled by default."
},
"discount_type": {
"enum": [
"percentage",
"amount"
],
"type": "string",
"default": "percentage",
"description": "The type of the discount's value."
},
"duration_unit": {
"type": "string",
"allOf": [
{
"enum": [
"hourly",
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string",
"title": "dealProductUnitDuration"
}
],
"description": "The unit duration of the product"
},
"product_variation_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the product variation to use. When omitted, no variation will be used."
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal-product (the ID of the product attached to the deal)"
},
"sum": {
"type": "number",
"description": "The sum of all the products attached to the deal"
},
"tax": {
"type": "number",
"description": "The product tax"
},
"name": {
"type": "string",
"description": "The product name"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal"
},
"add_time": {
"type": "string",
"description": "The date and time when the product was added to the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal product"
},
"last_edit": {
"type": "string",
"description": "The date and time when the deal product was last edited"
},
"company_id": {
"type": "integer",
"description": "The ID of the company"
},
"product_id": {
"type": "integer",
"description": "The ID of the product"
},
"active_flag": {
"type": "boolean",
"description": "Whether the product is active or not"
},
"duration_unit": {
"type": "string",
"description": "The type of the duration. (For example hourly, daily, etc.)"
}
}
}
]
},
{
"type": "object",
"properties": {
"product_attachment_id": {
"type": "integer",
"description": "The ID of the deal-product (the ID of the product attached to the deal)"
}
}
}
]
}
],
"description": "The added product object attached to the deal"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsCreateDealRequest
{
"allOf": [
{
"type": "object",
"title": "requredTitleParameter",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"description": "The title of the deal"
}
}
},
{
"type": "object",
"title": "newDealParameters",
"properties": {
"label": {
"type": "array",
"items": {
"type": "integer"
},
"description": "The array of the labels IDs."
},
"value": {
"type": "string",
"description": "The value of the deal. If omitted, value will be set to 0."
},
"org_id": {
"type": "integer",
"description": "The ID of an organization which this deal will be linked to. If the organization does not exist yet, it needs to be created first. This property is required unless `person_id` is specified."
},
"status": {
"enum": [
"open",
"won",
"lost",
"deleted"
],
"type": "string",
"description": "open = Open, won = Won, lost = Lost, deleted = Deleted. If omitted, status will be set to open."
},
"user_id": {
"type": "integer",
"description": "The ID of the user which will be the owner of the created deal. If not provided, the user making the request will be used."
},
"add_time": {
"type": "string",
"description": "The optional creation date & time of the deal in UTC. Requires admin user API token. Format: YYYY-MM-DD HH:MM:SS"
},
"currency": {
"type": "string",
"description": "The currency of the deal. Accepts a 3-character currency code. If omitted, currency will be set to the default currency of the authorized user."
},
"stage_id": {
"type": "integer",
"description": "The ID of the stage this deal will be added to. Please note that a pipeline will be assigned automatically based on the `stage_id`. If omitted, the deal will be placed in the first stage of the default pipeline."
},
"person_id": {
"type": "integer",
"description": "The ID of a person which this deal will be linked to. If the person does not exist yet, it needs to be created first. This property is required unless `org_id` is specified."
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline this deal will be added to. By default, the deal will be added to the first stage of the specified pipeline. Please note that `pipeline_id` and `stage_id` should not be used together as `pipeline_id` will be ignored."
}
}
},
{
"type": "object",
"title": "basicDeal",
"properties": {
"won_time": {
"type": "string",
"description": "The optional date and time of changing the deal status as won in UTC. Format: YYYY-MM-DD HH:MM:SS. Can be set only when deal `status` is already Won. Can not be used together with `lost_time`."
},
"lost_time": {
"type": "string",
"description": "The optional date and time of changing the deal status as lost in UTC. Format: YYYY-MM-DD HH:MM:SS. Can be set only when deal `status` is already Lost. Can not be used together with `won_time`."
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The optional date and time of closing the deal in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"visible_to": {
"type": "string",
"allOf": [
{
"enum": [
"1",
"3",
"5",
"7"
],
"type": "string"
}
],
"description": "The visibility of the deal. If omitted, the visibility will be set to the default visibility setting of this item type for the authorized user. Read more about visibility groups <a href=\"https://support.pipedrive.com/en/article/visibility-groups\" target=\"_blank\" rel=\"noopener noreferrer\">here</a>.<h4>Essential / Advanced plan</h4><table><tr><th style=\"width:40px\">Value</th><th>Description</th></tr><tr><td>`1`</td><td>Owner & followers</td><tr><td>`3`</td><td>Entire company</td></tr></table><h4>Professional / Enterprise plan</h4><table><tr><th style=\"width:40px\">Value</th><th>Description</th></tr><tr><td>`1`</td><td>Owner only</td><tr><td>`3`</td><td>Owner's visibility group</td></tr><tr><td>`5`</td><td>Owner's visibility group and sub-groups</td></tr><tr><td>`7`</td><td>Entire company</td></tr></table>"
},
"lost_reason": {
"type": "string",
"description": "The optional message about why the deal was lost (to be used when status = lost)"
},
"probability": {
"type": "number",
"description": "The success probability percentage of the deal. Used/shown only when `deal_probability` for the pipeline of the deal is enabled."
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal. In ISO 8601 format: YYYY-MM-DD."
}
}
}
],
"title": "addDealRequest"
}
DealsCreateDealResponse
{
"type": "object",
"title": "dealResponse200",
"properties": {
"data": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"address": {
"type": "string",
"description": "The address of the organization that is associated with the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the deal"
}
},
"description": "The organization which is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
}
}
}
],
"title": "dealOrganizationDataWithId"
},
"user_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "boolean",
"description": "If the user has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
},
"description": "The user who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the user"
}
}
}
],
"title": "dealUserDataWithId"
},
"person_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "If this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the deal"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the deal"
},
"primary": {
"type": "boolean",
"description": "If this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
},
"description": "The person who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the person associated with the deal"
}
}
}
],
"title": "dealPersonDataWithId"
},
"creator_user_id": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal creator"
},
"name": {
"type": "string",
"description": "The name of the deal creator"
},
"email": {
"type": "string",
"description": "The email of the deal creator"
},
"value": {
"type": "integer",
"description": "The ID of the deal creator"
},
"has_pic": {
"type": "boolean",
"description": "If the creator has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The creator picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the creator is active or not"
}
},
"description": "The creator of the deal"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealNonStrict"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
DealsDeleteAttachedProductResponse
{
"type": "object",
"title": "deleteDealProductResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of an attached product that was deleted from the deal"
}
}
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
}
}
}
DealsDeleteBulkResponse
{
"type": "object",
"title": "deleteDealsResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "array",
"items": {
"type": "integer"
},
"description": "The list of deleted deals IDs"
}
}
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsDeleteParticipantResponse
{
"type": "object",
"title": "deleteDealParticipantResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal participant that was deleted"
}
}
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
}
}
}
DealsDuplicateDealResponse
{
"type": "object",
"title": "duplicateDealResponse200",
"properties": {
"data": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
},
"user_id": {
"type": "integer",
"description": "The ID of the user"
},
"person_id": {
"type": "integer",
"description": "The ID of the person associated with the deal"
},
"creator_user_id": {
"type": "integer",
"description": "The ID of the deal creator"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealStrict"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsGetAllDeals200Response
{
"type": "object",
"title": "getDealsCollectionResponse200",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"title": "dealCollectionResponseObject",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"org_id": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"user_id": {
"type": "integer",
"description": "The ID of the user"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status to won in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status to lost in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"person_id": {
"type": "integer",
"description": "The ID of the person associated with the deal"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"update_time": {
"type": "string",
"description": "The last update date and time of the deal in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"creator_user_id": {
"type": "integer",
"description": "The ID of the deal creator"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
}
}
}
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
},
"additional_data": {
"type": "object",
"properties": {
"next_cursor": {
"type": "string",
"description": "The first item on the next page. The value of the `next_cursor` field will be `null` if you have reached the end of the dataset and there’s no more pages to be returned."
}
},
"description": "The additional data of the list"
}
}
}
DealsGetAllDeals403Response
{
"type": "object",
"title": "failResponse",
"properties": {
"error": {
"type": "string",
"description": "The error message"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsGetAllDealsResponse
{
"type": "object",
"title": "getDealsResponse200",
"properties": {
"data": {
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"address": {
"type": "string",
"description": "The address of the organization that is associated with the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the deal"
}
},
"description": "The organization which is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
}
}
}
],
"title": "dealOrganizationDataWithId"
},
"user_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "boolean",
"description": "If the user has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
},
"description": "The user who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the user"
}
}
}
],
"title": "dealUserDataWithId"
},
"person_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "If this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the deal"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the deal"
},
"primary": {
"type": "boolean",
"description": "If this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
},
"description": "The person who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the person associated with the deal"
}
}
}
],
"title": "dealPersonDataWithId"
},
"creator_user_id": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal creator"
},
"name": {
"type": "string",
"description": "The name of the deal creator"
},
"email": {
"type": "string",
"description": "The email of the deal creator"
},
"value": {
"type": "integer",
"description": "The ID of the deal creator"
},
"has_pic": {
"type": "boolean",
"description": "If the creator has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The creator picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the creator is active or not"
}
},
"description": "The creator of the deal"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealNonStrict"
},
"description": "The array of deals"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
DealsGetDetailsResponse
{
"type": "object",
"title": "getDealResponse200",
"properties": {
"data": {
"allOf": [
{
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"address": {
"type": "string",
"description": "The address of the organization that is associated with the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the deal"
}
},
"description": "The organization which is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
}
}
}
],
"title": "dealOrganizationDataWithId"
},
"user_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "boolean",
"description": "If the user has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
},
"description": "The user who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the user"
}
}
}
],
"title": "dealUserDataWithId"
},
"person_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "If this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the deal"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the deal"
},
"primary": {
"type": "boolean",
"description": "If this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
},
"description": "The person who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the person associated with the deal"
}
}
}
],
"title": "dealPersonDataWithId"
},
"creator_user_id": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal creator"
},
"name": {
"type": "string",
"description": "The name of the deal creator"
},
"email": {
"type": "string",
"description": "The email of the deal creator"
},
"value": {
"type": "integer",
"description": "The ID of the deal creator"
},
"has_pic": {
"type": "boolean",
"description": "If the creator has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The creator picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the creator is active or not"
}
},
"description": "The creator of the deal"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealNonStrict"
},
{
"type": "object",
"properties": {
"age": {
"type": "object",
"properties": {
"d": {
"type": "integer",
"description": "Days"
},
"h": {
"type": "integer",
"description": "Hours"
},
"i": {
"type": "integer",
"description": "Minutes"
},
"m": {
"type": "integer",
"description": "Months"
},
"s": {
"type": "integer",
"description": "Seconds"
},
"y": {
"type": "integer",
"description": "Years"
},
"total_seconds": {
"type": "integer",
"description": "The total time in seconds"
}
},
"description": "The lifetime of the deal"
},
"last_activity": {
"type": "object",
"nullable": true,
"description": "The details of the last activity associated with the deal"
},
"next_activity": {
"type": "object",
"nullable": true,
"description": "The details of the next activity associated with the deal"
},
"average_time_to_won": {
"type": "object",
"properties": {
"d": {
"type": "integer",
"description": "Days"
},
"h": {
"type": "integer",
"description": "Hours"
},
"i": {
"type": "integer",
"description": "Minutes"
},
"m": {
"type": "integer",
"description": "Months"
},
"s": {
"type": "integer",
"description": "Seconds"
},
"y": {
"type": "integer",
"description": "Years"
},
"total_seconds": {
"type": "integer",
"description": "The total time in seconds"
}
},
"description": "The average time to win the deal"
},
"average_stage_progress": {
"type": "number",
"description": "The average of the deal stage progression"
},
"stay_in_pipeline_stages": {
"type": "object",
"properties": {
"order_of_stages": {
"type": "array",
"items": {
"type": "integer"
},
"description": "The order of the deal progression through the pipeline stages"
},
"times_in_stages": {
"type": "object",
"description": "The number of seconds a deal has been in each stage of the pipeline"
}
},
"description": "The details of the duration of the deal being in each stage of the pipeline"
}
}
}
],
"title": "dealNonStrictWithDetails"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
},
"additional_data": {
"type": "object",
"properties": {
"dropbox_email": {
"type": "string",
"description": "The BCC email of the deal"
}
}
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
DealsGetSummaryResponse
{
"type": "object",
"title": "getDealsSummaryResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"total_count": {
"type": "integer",
"description": "The total number of deals"
},
"values_total": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "The number of deals in the deal currency group"
},
"value": {
"type": "number",
"description": "The total value of deals in the deal currency group"
},
"value_converted": {
"type": "number",
"description": "The total value of deals converted into the company default currency"
},
"value_formatted": {
"type": "string",
"description": "The total value of deals formatted with deal currency. E.g. €50"
},
"value_converted_formatted": {
"type": "string",
"description": "The value_converted formatted with deal currency. E.g. US$50.10"
}
},
"description": "The total values of the deals grouped by deal currency"
},
"weighted_values_total": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "The number of deals in the deal currency group"
},
"value": {
"type": "number",
"description": "The total weighted value of the deals in the deal currency group"
},
"value_formatted": {
"type": "string",
"description": "The total weighted value of the deals formatted with deal currency. E.g. €50"
}
},
"description": "The total weighted values of the deals grouped by deal currency. The weighted value is calculated as probability times deal value."
},
"total_currency_converted_value": {
"type": "number",
"description": "The total value of deals converted into the company default currency"
},
"total_weighted_currency_converted_value": {
"type": "number",
"description": "The total weighted value of deals converted into the company default currency"
},
"total_currency_converted_value_formatted": {
"type": "string",
"description": "The total converted value of deals formatted with the company default currency. E.g. US$5,100.96"
},
"total_weighted_currency_converted_value_formatted": {
"type": "string",
"description": "The total weighted value of deals formatted with the company default currency. E.g. US$5,100.96"
}
},
"description": "The summary of deals"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsGetTimelineDataResponse
{
"type": "object",
"title": "getDealsTimelineResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"deals": {
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
},
"user_id": {
"type": "integer",
"description": "The ID of the user"
},
"person_id": {
"type": "integer",
"description": "The ID of the person associated with the deal"
},
"creator_user_id": {
"type": "integer",
"description": "The ID of the deal creator"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealStrict"
}
},
"totals": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "The number of deals for the given period"
},
"values": {
"type": "object",
"description": "The total values of deals grouped by deal currency"
},
"won_count": {
"type": "integer",
"description": "The number of won deals for the given period"
},
"open_count": {
"type": "integer",
"description": "The number of open deals for the given period"
},
"won_values": {
"type": "object",
"description": "The total values of won deals for the given period grouped by deal currency"
},
"open_values": {
"type": "object",
"description": "The total values of open deals for the given period grouped by deal currency"
},
"weighted_values": {
"type": "object",
"description": "The total weighted values of deals for the given period grouped by deal currency. The weighted value of a deal is calculated as probability times deal value."
},
"weighted_open_values": {
"type": "object",
"description": "The total weighted values of open deals for the given period grouped by deal currency. The weighted value of a deal is calculated as probability times deal value."
}
},
"description": "The total values of deals for the given period"
},
"period_end": {
"type": "string",
"description": "The end date and time of the period"
},
"period_start": {
"type": "string",
"description": "The start date and time of the period"
}
},
"description": "Open and won deals grouped into periods by defined interval, amount and date-type dealField (`field_key`)"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsListActivitiesResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"org_id": {
"type": "integer",
"description": "The ID of the organization this activity is associated with"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal this activity is associated with"
},
"lead_id": {
"type": "string",
"format": "uuid",
"nullable": true,
"description": "The ID of the lead in the UUID format this activity is associated with"
},
"due_date": {
"type": "string",
"format": "date",
"description": "The due date of the activity. Format: YYYY-MM-DD"
},
"due_time": {
"type": "string",
"description": "The due time of the activity in UTC. Format: HH:MM"
},
"duration": {
"type": "string",
"description": "The duration of the activity. Format: HH:MM"
},
"location": {
"type": "string",
"description": "The address of the activity. Pipedrive will automatically check if the location matches a geo-location on Google maps."
},
"person_id": {
"type": "integer",
"description": "The ID of the person this activity is associated with"
},
"project_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the project this activity is associated with"
},
"public_description": {
"type": "string",
"description": "Additional details about the activity that is synced to your external calendar. Unlike the note added to the activity, the description is publicly visible to any guests added to the activity."
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the activity, generated when the activity was created"
},
"done": {
"type": "boolean",
"description": "Whether the activity is done or not"
},
"file": {
"type": "object",
"description": "The file that is attached to this activity. For example, this can be a reference to an audio note file generated with Pipedrive mobile app."
},
"note": {
"type": "string",
"description": "The note of the activity (HTML format)"
},
"type": {
"type": "string",
"description": "The type of the activity. This is in correlation with the `key_string` parameter of ActivityTypes."
},
"series": {
"type": "array",
"items": {
"type": "object"
},
"description": "The list of recurring activity instances. It is in a structure as follows: `[{due_date: \"2020-06-24\", due_time: \"10:00:00\"}]`"
},
"subject": {
"type": "string",
"description": "The subject of the activity"
},
"user_id": {
"type": "integer",
"description": "The ID of the user whom the activity is assigned to"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the activity in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"org_name": {
"type": "string",
"description": "The name of the organization this activity is associated with"
},
"rec_rule": {
"type": "string",
"description": "The rule for the recurrence of the activity. Is important for activities synced into Pipedrive from an external calendar. Example: \"RRULE:FREQ=WEEKLY;BYDAY=WE\""
},
"attendees": {
"type": "array",
"items": {
"type": "object"
},
"nullable": true,
"description": "The attendees of the activity. This can be either your existing Pipedrive contacts or an external email address."
},
"busy_flag": {
"type": "boolean",
"description": "Marks if the activity is set as 'Busy' or 'Free'. If the flag is set to `true`, your customers will not be able to book that time slot through any Scheduler links. The flag can also be unset. When the value of the flag is unset (`null`), the flag defaults to 'Busy' if it has a time set, and 'Free' if it is an all-day event without specified time."
},
"company_id": {
"type": "integer",
"description": "The user's company ID"
},
"deal_title": {
"type": "string",
"description": "The name of the deal this activity is associated with"
},
"owner_name": {
"type": "string",
"description": "The name of the user this activity is owned by"
},
"active_flag": {
"type": "boolean",
"description": "Whether the activity is active or not"
},
"person_name": {
"type": "string",
"description": "The name of the person this activity is associated with"
},
"update_time": {
"type": "string",
"description": "The last update date and time of the activity. Format: YYYY-MM-DD HH:MM:SS."
},
"participants": {
"type": "array",
"items": {
"type": "object"
},
"nullable": true,
"description": "List of multiple persons (participants) this activity is associated with"
},
"reference_id": {
"type": "integer",
"description": "Together with the `reference_type`, gives the ID of the other object"
},
"gcal_event_id": {
"type": "string",
"description": "For the activity which syncs to Google calendar, this is the Google event ID. NB! This field is related to old Google calendar sync and will be deprecated soon."
},
"location_route": {
"type": "string",
"description": "A subfield of the location field. Indicates street name."
},
"reference_type": {
"type": "string",
"description": "If the activity references some other object, it is indicated here. For example, value `Salesphone` refers to activities created with Caller."
},
"update_user_id": {
"type": "integer",
"description": "The ID of the user who was the last to update this activity"
},
"source_timezone": {
"type": "string",
"description": "The timezone the activity was created in an external calendar"
},
"deal_dropbox_bcc": {
"type": "string",
"description": "The BCC email address of the deal"
},
"location_country": {
"type": "string",
"description": "A subfield of the location field. Indicates country."
},
"location_locality": {
"type": "string",
"description": "A subfield of the location field. Indicates city/town/village/locality."
},
"created_by_user_id": {
"type": "integer",
"description": "The ID of the user who created the activity"
},
"google_calendar_id": {
"type": "string",
"description": "The Google calendar ID that this activity syncs to. NB! This field is related to old Google calendar sync and will be deprecated soon."
},
"person_dropbox_bcc": {
"type": "string",
"description": "The BCC email address of the person"
},
"rec_rule_extension": {
"type": "string",
"description": "Additional rules for the recurrence of the activity, extend the `rec_rule`. Is important for activities synced into Pipedrive from an external calendar."
},
"assigned_to_user_id": {
"type": "integer",
"description": "The ID of the user to whom the activity is assigned to. Equal to `user_id`."
},
"location_subpremise": {
"type": "string",
"description": "A subfield of the location field. Indicates apartment/suite number."
},
"marked_as_done_time": {
"type": "string",
"description": "The date and time this activity was marked as done. Format: YYYY-MM-DD HH:MM:SS."
},
"google_calendar_etag": {
"type": "string",
"description": "The Google calendar API etag (version) that is used for syncing this activity. NB! This field is related to old Google calendar sync and will be deprecated soon."
},
"location_postal_code": {
"type": "string",
"description": "A subfield of the location field. Indicates ZIP/postal code."
},
"location_sublocality": {
"type": "string",
"description": "A subfield of the location field. Indicates district/sublocality."
},
"conference_meeting_id": {
"type": "string",
"description": "The meeting ID of the meeting provider (Zoom, MS Teams etc.) that is associated with this activity"
},
"conference_meeting_url": {
"type": "string",
"description": "The link to join the meeting which is associated with this activity"
},
"last_notification_time": {
"type": "string",
"description": "The date and time of latest notifications sent about this activity to the participants or the attendees of this activity"
},
"location_street_number": {
"type": "string",
"description": "A subfield of the location field. Indicates house number."
},
"rec_master_activity_id": {
"type": "integer",
"description": "The ID of parent activity for a recurrent activity if the current activity is an exception to recurrence rules"
},
"notification_language_id": {
"type": "integer",
"description": "The ID of the language the notifications are sent in"
},
"conference_meeting_client": {
"type": "string",
"description": "The ID of the Marketplace app, which is connected to this activity"
},
"last_notification_user_id": {
"type": "integer",
"description": "The ID of the user who triggered the sending of the latest notifications about this activity to the participants or the attendees of this activity"
},
"location_formatted_address": {
"type": "string",
"description": "A subfield of the location field. Indicates full/combined address."
},
"location_admin_area_level_1": {
"type": "string",
"description": "A subfield of the location field. Indicates state/county."
},
"location_admin_area_level_2": {
"type": "string",
"description": "A subfield of the location field. Indicates region."
},
"calendar_sync_include_context": {
"type": "string",
"description": "For activities that sync to an external calendar, this setting indicates if the activity syncs with context (what are the deals, persons, organizations this activity is related to)"
}
}
}
],
"title": "activityResponseObject"
},
"description": "The array of activities"
},
"additional_data": {
"allOf": [
{
"type": "object",
"properties": {
"activity_distribution": {
"type": "object",
"properties": {
"ASSIGNED_TO_USER_ID": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the user"
},
"share": {
"type": "integer",
"description": "The percentage of activities belongs to the user"
},
"activities": {
"type": "object",
"properties": {
"ACTIVITY_TYPE_NAME": {
"type": "integer",
"description": "The count of activities related to a specific type"
}
},
"description": "The count of activities related to the user grouped by activity type"
},
"activity_count": {
"type": "integer",
"description": "The overall count of activities for the user"
}
},
"description": "The ID of the user"
}
},
"description": "The distribution of activities related to the organization grouped by the user ID"
}
}
},
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
}
],
"title": "activityDistributionDataWithAdditionalData"
},
"related_objects": {
"type": "object",
"properties": {
"deal": {
"type": "object",
"properties": {
"DEAL_ID": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal associated with the item"
},
"title": {
"type": "string",
"description": "The title of the deal associated with the item"
},
"value": {
"type": "number",
"description": "The value of the deal that is associated with the item"
},
"status": {
"type": "string",
"description": "The status of the deal associated with the item"
},
"currency": {
"type": "string",
"description": "The currency of the deal value"
},
"stage_id": {
"type": "integer",
"description": "The ID of the stage the deal is currently at"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline the deal is in"
}
},
"description": "The ID of the deal which is associated with the item"
}
}
},
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
],
"title": "getDealActivitiesResponse200"
}
DealsListChangelogResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "The date and time of the change"
},
"field_key": {
"type": "string",
"description": "The key of the field that was changed"
},
"new_value": {
"type": "string",
"nullable": true,
"description": "The value of the field after the change"
},
"old_value": {
"type": "string",
"nullable": true,
"description": "The value of the field before the change"
},
"actor_user_id": {
"type": "integer",
"description": "The ID of the user who made the change"
},
"change_source": {
"type": "string",
"nullable": true,
"description": "The source of change, for example 'app', 'mobile', 'api', etc."
},
"is_bulk_update_flag": {
"type": "boolean",
"description": "Whether the change was made as part of a bulk update"
},
"change_source_user_agent": {
"type": "string",
"nullable": true,
"description": "The user agent from which the change was made"
}
}
}
},
"additional_data": {
"type": "object",
"properties": {
"next_cursor": {
"type": "string",
"description": "The first item on the next page. The value of the `next_cursor` field will be `null` if you have reached the end of the dataset and there’s no more pages to be returned."
}
},
"description": "The additional data of the list"
}
}
}
],
"title": "getChangelogResponse200"
}
DealsListDealFilesResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the file"
},
"cid": {
"type": "string",
"description": "The ID of the inline attachment"
},
"url": {
"type": "string",
"description": "The URL of the download file"
},
"name": {
"type": "string",
"description": "The visible name of the file"
},
"org_id": {
"type": "integer",
"description": "The ID of the organization to associate the file with"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal to associate the file with"
},
"lead_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the lead to associate the file with"
},
"user_id": {
"type": "integer",
"description": "The ID of the user to associate the file with"
},
"add_time": {
"type": "string",
"description": "The date and time when the file was added/created. Format: YYYY-MM-DD HH:MM:SS"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the file"
},
"deal_name": {
"type": "string",
"description": "The name of the deal associated with the dile"
},
"file_name": {
"type": "string",
"description": "The original name of the file"
},
"file_size": {
"type": "integer",
"description": "The size of the file"
},
"lead_name": {
"type": "string",
"description": "The name of the lead associated with the file"
},
"person_id": {
"type": "integer",
"description": "The ID of the person to associate the file with"
},
"remote_id": {
"type": "string",
"description": "The ID of the remote item"
},
"s3_bucket": {
"type": "string",
"description": "The location of the cloud storage"
},
"product_id": {
"type": "integer",
"description": "The ID of the product to associate the file with"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not. false = Not activated, true = Activated"
},
"activity_id": {
"type": "integer",
"description": "The ID of the activity to associate the file with"
},
"description": {
"type": "string",
"description": "The description of the file"
},
"inline_flag": {
"type": "boolean",
"description": "Whether the file was uploaded as inline or not"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the file"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the file. Format: YYYY-MM-DD HH:MM:SS"
},
"product_name": {
"type": "string",
"description": "The name of the product associated with the file"
},
"mail_message_id": {
"type": "string",
"description": "The ID of the mail message to associate the file with"
},
"remote_location": {
"type": "string",
"description": "The location type to send the file to. Only googledrive is supported at the moment."
},
"mail_template_id": {
"type": "string",
"description": "The ID of the mail template to associate the file with"
}
},
"description": "The file data"
},
"description": "The array of files"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
}
}
}
],
"title": "getAssociatedFilesResponse200"
}
DealsListDealProductsResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal-product (the ID of the product attached to the deal)"
},
"sum": {
"type": "number",
"description": "The sum of all the products attached to the deal"
},
"tax": {
"type": "number",
"description": "The product tax"
},
"name": {
"type": "string",
"description": "The product name"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal"
},
"product": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The ID of the product"
},
"tax": {
"type": "number",
"default": 0,
"description": "The ax percentage"
},
"code": {
"type": "string",
"description": "The product code"
},
"name": {
"type": "string",
"description": "The name of the product"
},
"unit": {
"type": "string",
"description": "The unit in which this product is sold"
},
"owner_id": {
"type": "object",
"description": "Information about the Pipedrive user who owns the product"
},
"selectable": {
"type": "boolean",
"default": true,
"description": "Whether this product is selected in deals or not"
},
"visible_to": {
"allOf": [
{
"enum": [
"1",
"3",
"5",
"7"
],
"type": "string"
}
],
"description": "Visibility of the product"
},
"active_flag": {
"type": "boolean",
"default": true,
"description": "Whether this product is active or not"
}
}
},
{
"type": "object",
"properties": {
"prices": {
"type": "object",
"description": "Object of objects, each containing: currency (string), price (number), cost (number, optional), overhead_cost (number, optional)"
}
}
}
]
},
"add_time": {
"type": "string",
"description": "The date and time when the product was added to the deal"
},
"comments": {
"type": "string",
"description": "The comments of the product"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal product"
},
"discount": {
"type": "number",
"default": 0,
"description": "The value of the discount. The `discount_type` field can be used to specify whether the value is an amount or a percentage."
},
"duration": {
"type": "integer",
"description": "The duration of the product"
},
"order_nr": {
"type": "integer",
"description": "The order number of the product"
},
"quantity": {
"type": "integer",
"description": "The quantity of the product"
},
"last_edit": {
"type": "string",
"description": "The date and time when the deal product was last edited"
},
"item_price": {
"type": "integer",
"description": "The price value of the product"
},
"product_id": {
"type": "integer",
"description": "The ID of the product"
},
"tax_method": {
"enum": [
"exclusive",
"inclusive",
"none"
],
"type": "string",
"description": "The tax option to be applied to the products. When using `inclusive`, the tax percentage will already be included in the price. When using `exclusive`, the tax will not be included in the price. When using `none`, no tax will be added. Use the `tax` field for defining the tax percentage amount. By default, the user setting value for tax options will be used. Changing this in one product affects the rest of the products attached to the deal."
},
"active_flag": {
"type": "boolean",
"description": "Whether the product is active or not"
},
"enabled_flag": {
"type": "boolean",
"description": "Whether the product is enabled or not"
},
"discount_type": {
"enum": [
"percentage",
"amount"
],
"type": "string",
"default": "percentage",
"description": "The type of the discount's value."
},
"duration_unit": {
"type": "string",
"description": "The type of the duration. (For example hourly, daily, etc.)"
},
"sum_formatted": {
"type": "string",
"description": "The formatted sum of the product"
},
"quantity_formatted": {
"type": "string",
"description": "The formatted quantity of the product"
},
"product_variation_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the product variation"
}
}
},
"description": "The array of products"
},
"additional_data": {
"allOf": [
{
"type": "object",
"properties": {
"products_sum_total": {
"type": "integer",
"description": "The total sum of the products"
},
"products_quantity_total": {
"type": "integer",
"description": "The total quantity of the products"
},
"products_sum_total_formatted": {
"type": "string",
"description": "The total formatted sum of the products"
},
"products_quantity_total_formatted": {
"type": "string",
"description": "The total formatted quantity of the products"
}
}
},
{
"type": "object",
"properties": {
"pagination": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"next_start": {
"type": "integer",
"description": "Next pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "Whether there are more list items in the collection than displayed"
}
},
"description": "Pagination details of the list"
}
}
}
]
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
}
}
}
}
}
],
"title": "listProductsResponse200"
}
DealsListDealUpdatesResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "The data related to the update"
},
"object": {
"type": "string",
"description": "The type of the deal update. (Possible object types - dealChange, note, activity, mailMessage, invoice, document, file)"
},
"timestamp": {
"type": "string",
"description": "The creation date and time of the update"
}
}
}
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
},
"related_objects": {
"type": "object",
"properties": {
"deal": {
"type": "object",
"properties": {
"DEAL_ID": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal associated with the item"
},
"title": {
"type": "string",
"description": "The title of the deal associated with the item"
},
"value": {
"type": "number",
"description": "The value of the deal that is associated with the item"
},
"status": {
"type": "string",
"description": "The status of the deal associated with the item"
},
"currency": {
"type": "string",
"description": "The currency of the deal value"
},
"stage_id": {
"type": "integer",
"description": "The ID of the stage the deal is currently at"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline the deal is in"
}
},
"description": "The ID of the deal which is associated with the item"
}
}
},
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
],
"title": "getDealUpdatesResponse200"
}
DealsListFollowersResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user follower"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal which the follower was added to"
},
"user_id": {
"type": "integer",
"description": "The ID of the user"
},
"add_time": {
"type": "string",
"description": "The date and time when the follower was added to the person"
}
}
},
"description": "The list of followers"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
}
}
}
],
"title": "getAssociatedFollowersResponse200"
}
DealsListMailMessagesResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"allOf": [
{
"type": "object",
"properties": {
"cc": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "ID of the mail participant"
},
"name": {
"type": "string",
"description": "Name of the mail participant"
},
"email_address": {
"type": "string",
"description": "Mail address of the mail participant"
},
"linked_person_id": {
"type": "integer",
"description": "ID of the linked person to the mail message"
},
"linked_person_name": {
"type": "string",
"description": "Name of the linked person to the mail message"
},
"mail_message_party_id": {
"type": "integer",
"description": "ID of the mail message participant"
}
}
},
"description": "The array of mail message copies (object)"
},
"id": {
"type": "integer",
"description": "ID of the mail message."
},
"to": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "ID of the mail participant"
},
"name": {
"type": "string",
"description": "Name of the mail participant"
},
"email_address": {
"type": "string",
"description": "Mail address of the mail participant"
},
"linked_person_id": {
"type": "integer",
"description": "ID of the linked person to the mail message"
},
"linked_person_name": {
"type": "string",
"description": "Name of the linked person to the mail message"
},
"mail_message_party_id": {
"type": "integer",
"description": "ID of the mail message participant"
}
}
},
"description": "The array of mail message receiver (object)"
},
"bcc": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "ID of the mail participant"
},
"name": {
"type": "string",
"description": "Name of the mail participant"
},
"email_address": {
"type": "string",
"description": "Mail address of the mail participant"
},
"linked_person_id": {
"type": "integer",
"description": "ID of the linked person to the mail message"
},
"linked_person_name": {
"type": "string",
"description": "Name of the linked person to the mail message"
},
"mail_message_party_id": {
"type": "integer",
"description": "ID of the mail message participant"
}
}
},
"description": "The array of mail message blind copies (object)"
},
"from": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "ID of the mail participant"
},
"name": {
"type": "string",
"description": "Name of the mail participant"
},
"email_address": {
"type": "string",
"description": "Mail address of the mail participant"
},
"linked_person_id": {
"type": "integer",
"description": "ID of the linked person to the mail message"
},
"linked_person_name": {
"type": "string",
"description": "Name of the linked person to the mail message"
},
"mail_message_party_id": {
"type": "integer",
"description": "ID of the mail message participant"
}
}
},
"description": "The array of mail message sender (object)"
},
"draft": {
"type": "string",
"description": "If the mail message has a draft status then the value is the mail message object as JSON formatted string, otherwise `null`."
},
"snippet": {
"type": "string",
"description": "The snippet of mail message. Snippet length is up to 225 characters."
},
"subject": {
"type": "string",
"description": "The subject of mail message"
},
"user_id": {
"type": "integer",
"description": "ID of the user whom mail message will be assigned to"
},
"add_time": {
"type": "string",
"format": "date-time",
"description": "The insertion into the database time of the mail message"
},
"body_url": {
"type": "string",
"description": "The mail message body URL"
},
"read_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message is read or not by the user"
},
"sent_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has been sent or not"
},
"account_id": {
"type": "string",
"description": "The connection account ID"
},
"draft_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message is a draft or not"
},
"synced_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message is synced with the provider or not"
},
"update_time": {
"type": "string",
"format": "date-time",
"description": "The updating time in the database of the mail message"
},
"deleted_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message is deleted or not"
},
"message_time": {
"type": "string",
"format": "date-time",
"description": "Creation or receival time of the mail message"
},
"has_body_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has a body or not"
},
"mail_thread_id": {
"type": "integer",
"description": "ID of the mail message thread"
},
"smart_bcc_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has been created by Smart Email BCC feature or not"
},
"has_attachments_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has an attachment or not"
},
"mail_tracking_status": {
"enum": [
"opened",
"not opened"
],
"type": "string",
"nullable": true,
"description": "The status of tracking mail message. Value is `null` if tracking is not enabled."
},
"sent_from_pipedrive_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has been sent from Pipedrive app or not"
},
"has_real_attachments_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has an attachment (which is not inline) or not"
},
"has_inline_attachments_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the mail message has an inline attachment or not"
},
"mail_link_tracking_enabled_flag": {
"allOf": [
{
"enum": [
0,
1
],
"type": "number",
"title": "numberBooleanDefault0",
"default": 0
}
],
"description": "Whether the link tracking in mail message body is enabled."
}
}
},
{
"type": "object",
"properties": {
"nylas_id": {
"type": "string",
"description": "The Mail Message ID assigned by the sync provider"
},
"item_type": {
"type": "string",
"description": "The type of the data item"
},
"s3_bucket": {
"type": "string",
"description": "The name of the S3 bucket"
},
"timestamp": {
"type": "string",
"description": "The add date and time of the Mail Message"
},
"company_id": {
"type": "integer",
"description": "The ID of the company"
},
"template_id": {
"type": "integer",
"description": "The ID of the mail template"
},
"mua_message_id": {
"type": "string",
"description": "The Mail Message ID assigned by the mail user agent"
},
"s3_bucket_path": {
"type": "string",
"description": "The path of the S3 bucket"
},
"external_deleted_flag": {
"type": "boolean",
"description": "If the Mail Message has been deleted on the provider side or not"
}
}
}
],
"title": "mailMessageItemForList"
},
"object": {
"type": "string",
"description": "The type of the data item"
},
"timestamp": {
"type": "string",
"description": "The date and time when the item was created"
}
}
},
"description": "The array of mail messages"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
}
}
}
],
"title": "getAssociatedMailMessagesResponse200"
}
DealsListParticipantsChangelogResponse
{
"type": "object",
"title": "getParticipantsChangelog200",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "The deal participant action log time"
},
"action": {
"type": "string",
"description": "Deal participant action type"
},
"person_id": {
"type": "integer",
"description": "The ID of the person"
},
"actor_user_id": {
"type": "integer",
"description": "The ID of the user"
}
}
}
],
"title": "participantChangelogItem"
},
"description": "The array of participant changelog"
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
}
}
}
DealsListParticipantsResponse
{
"type": "object",
"title": "getDealParticipantsResponse200",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The label that indicates the type of the email. (Possible values - work, home or other)"
},
"value": {
"type": "string",
"description": "Email"
},
"primary": {
"type": "boolean",
"description": "Boolean that indicates if email is primary for the person or not"
}
}
},
"description": "An email address as a string or an array of email objects related to the person. The structure of the array is as follows: `[{ \"value\": \"mail@example.com\", \"primary\": \"true\", \"label\": \"main\" } ]`. Please note that only `value` is required."
},
"label": {
"type": "integer",
"description": "The label assigned to the person"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The label that indicates the type of the phone number. (Possible values - work, home, mobile or other)"
},
"value": {
"type": "string",
"description": "The phone number"
},
"primary": {
"type": "boolean",
"description": "Boolean that indicates if phone number is primary for the person or not"
}
}
},
"description": "A phone number supplied as a string or an array of phone objects related to the person. The structure of the array is as follows: `[{ \"value\": \"12345\", \"primary\": \"true\", \"label\": \"mobile\" }]`. Please note that only `value` is required."
},
"add_time": {
"type": "string",
"description": "The date and time when the person was added/created. Format: YYYY-MM-DD HH:MM:SS"
},
"cc_email": {
"type": "string",
"description": "The BCC email associated with the person"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the person"
},
"company_id": {
"type": "integer",
"description": "The ID of the company related to the person"
},
"first_char": {
"type": "string",
"description": "The first letter of the name of the person"
},
"owner_name": {
"type": "string",
"description": "The name of the owner associated with the person"
},
"picture_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the picture associated with the item"
}
}
},
{
"type": "object",
"properties": {
"item_id": {
"type": "integer",
"description": "The ID of related item"
},
"add_time": {
"type": "string",
"description": "The add time of the picture"
},
"pictures": {
"type": "object",
"properties": {
"128": {
"type": "string",
"description": "The URL of the 128*128 picture"
},
"512": {
"type": "string",
"description": "The URL of the 512*512 picture"
}
}
},
"item_type": {
"type": "string",
"description": "The type of item the picture is related to"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated picture is active or not"
},
"update_time": {
"type": "string",
"description": "The update time of the picture"
},
"added_by_user_id": {
"type": "integer",
"description": "The ID of the user who added the picture"
}
}
}
]
},
"visible_to": {
"type": "string",
"description": "The visibility group ID of who can see the person"
},
"active_flag": {
"type": "boolean",
"description": "Whether the person is active or not"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the person. Format: YYYY-MM-DD HH:MM:SS"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"org_id": {
"allOf": [
{
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization"
}
}
}
],
"title": "relationshipOrganizationInfoItem"
},
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
}
],
"title": "relationshipOrganizationInfoItemWithActiveFlag"
},
"owner_id": {
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the owner"
}
}
}
],
"title": "owner"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person"
},
"last_name": {
"type": "string",
"description": "The last name of the person"
},
"first_name": {
"type": "string",
"description": "The first name of the person"
}
}
}
],
"title": "personNameInfoWithOrgAndOwnerId"
},
{
"type": "object",
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"files_count": {
"type": "integer",
"description": "The count of files related to the person"
},
"notes_count": {
"type": "integer",
"description": "The count of notes related to the person"
},
"followers_count": {
"type": "integer",
"description": "The count of followers related to the person"
},
"activities_count": {
"type": "integer",
"description": "The count of activities related to the person"
},
"email_messages_count": {
"type": "integer",
"description": "The count of email messages related to the person"
},
"done_activities_count": {
"type": "integer",
"description": "The count of done activities related to the person"
},
"undone_activities_count": {
"type": "integer",
"description": "The count of undone activities related to the person"
}
}
},
{
"type": "object",
"properties": {
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the person"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the person"
}
}
}
],
"title": "personCountAndEmailInfo"
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"won_deals_count": {
"type": "integer",
"description": "The count of won deals related with the item"
},
"lost_deals_count": {
"type": "integer",
"description": "The count of lost deals related with the item"
},
"open_deals_count": {
"type": "integer",
"description": "The count of open deals related with the item"
},
"closed_deals_count": {
"type": "integer",
"description": "The count of closed deals related with the item"
},
"related_won_deals_count": {
"type": "integer",
"description": "The count of related won deals related with the item"
},
"related_lost_deals_count": {
"type": "integer",
"description": "The count of related lost deals related with the item"
},
"related_open_deals_count": {
"type": "integer",
"description": "The count of related open deals related with the item"
},
"related_closed_deals_count": {
"type": "integer",
"description": "The count of related closed deals related with the item"
}
}
},
{
"type": "object",
"properties": {
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"nullable": true,
"description": "The time of the next activity associated with the deal"
}
}
}
],
"title": "dealCountAndActivityInfo"
}
],
"title": "personCountEmailDealAndActivityInfo"
}
],
"title": "additionalPersonInfo"
}
],
"title": "personItem"
},
"description": "The array of participants"
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
DealsListPermittedUsersResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
],
"title": "listPermittedUsersResponse200"
}
DealsListPersonsAssociatedResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The label that indicates the type of the email. (Possible values - work, home or other)"
},
"value": {
"type": "string",
"description": "Email"
},
"primary": {
"type": "boolean",
"description": "Boolean that indicates if email is primary for the person or not"
}
}
},
"description": "An email address as a string or an array of email objects related to the person. The structure of the array is as follows: `[{ \"value\": \"mail@example.com\", \"primary\": \"true\", \"label\": \"main\" } ]`. Please note that only `value` is required."
},
"label": {
"type": "integer",
"description": "The label assigned to the person"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The label that indicates the type of the phone number. (Possible values - work, home, mobile or other)"
},
"value": {
"type": "string",
"description": "The phone number"
},
"primary": {
"type": "boolean",
"description": "Boolean that indicates if phone number is primary for the person or not"
}
}
},
"description": "A phone number supplied as a string or an array of phone objects related to the person. The structure of the array is as follows: `[{ \"value\": \"12345\", \"primary\": \"true\", \"label\": \"mobile\" }]`. Please note that only `value` is required."
},
"add_time": {
"type": "string",
"description": "The date and time when the person was added/created. Format: YYYY-MM-DD HH:MM:SS"
},
"cc_email": {
"type": "string",
"description": "The BCC email associated with the person"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the person"
},
"company_id": {
"type": "integer",
"description": "The ID of the company related to the person"
},
"first_char": {
"type": "string",
"description": "The first letter of the name of the person"
},
"owner_name": {
"type": "string",
"description": "The name of the owner associated with the person"
},
"picture_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the picture associated with the item"
}
}
},
{
"type": "object",
"properties": {
"item_id": {
"type": "integer",
"description": "The ID of related item"
},
"add_time": {
"type": "string",
"description": "The add time of the picture"
},
"pictures": {
"type": "object",
"properties": {
"128": {
"type": "string",
"description": "The URL of the 128*128 picture"
},
"512": {
"type": "string",
"description": "The URL of the 512*512 picture"
}
}
},
"item_type": {
"type": "string",
"description": "The type of item the picture is related to"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated picture is active or not"
},
"update_time": {
"type": "string",
"description": "The update time of the picture"
},
"added_by_user_id": {
"type": "integer",
"description": "The ID of the user who added the picture"
}
}
}
]
},
"visible_to": {
"type": "string",
"description": "The visibility group ID of who can see the person"
},
"active_flag": {
"type": "boolean",
"description": "Whether the person is active or not"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the person. Format: YYYY-MM-DD HH:MM:SS"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"org_id": {
"allOf": [
{
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization"
}
}
}
],
"title": "relationshipOrganizationInfoItem"
},
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
}
],
"title": "relationshipOrganizationInfoItemWithActiveFlag"
},
"owner_id": {
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the owner"
}
}
}
],
"title": "owner"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person"
},
"last_name": {
"type": "string",
"description": "The last name of the person"
},
"first_name": {
"type": "string",
"description": "The first name of the person"
}
}
}
],
"title": "personNameInfoWithOrgAndOwnerId"
},
{
"type": "object",
"allOf": [
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"files_count": {
"type": "integer",
"description": "The count of files related to the person"
},
"notes_count": {
"type": "integer",
"description": "The count of notes related to the person"
},
"followers_count": {
"type": "integer",
"description": "The count of followers related to the person"
},
"activities_count": {
"type": "integer",
"description": "The count of activities related to the person"
},
"email_messages_count": {
"type": "integer",
"description": "The count of email messages related to the person"
},
"done_activities_count": {
"type": "integer",
"description": "The count of done activities related to the person"
},
"undone_activities_count": {
"type": "integer",
"description": "The count of undone activities related to the person"
}
}
},
{
"type": "object",
"properties": {
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the person"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the person"
}
}
}
],
"title": "personCountAndEmailInfo"
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"won_deals_count": {
"type": "integer",
"description": "The count of won deals related with the item"
},
"lost_deals_count": {
"type": "integer",
"description": "The count of lost deals related with the item"
},
"open_deals_count": {
"type": "integer",
"description": "The count of open deals related with the item"
},
"closed_deals_count": {
"type": "integer",
"description": "The count of closed deals related with the item"
},
"related_won_deals_count": {
"type": "integer",
"description": "The count of related won deals related with the item"
},
"related_lost_deals_count": {
"type": "integer",
"description": "The count of related lost deals related with the item"
},
"related_open_deals_count": {
"type": "integer",
"description": "The count of related open deals related with the item"
},
"related_closed_deals_count": {
"type": "integer",
"description": "The count of related closed deals related with the item"
}
}
},
{
"type": "object",
"properties": {
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"nullable": true,
"description": "The time of the next activity associated with the deal"
}
}
}
],
"title": "dealCountAndActivityInfo"
}
],
"title": "personCountEmailDealAndActivityInfo"
}
],
"title": "additionalPersonInfo"
}
],
"title": "personItem"
},
"description": "The array of persons"
},
"additional_data": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "If there are more list items in the collection than displayed or not"
}
},
"description": "The additional data of the list"
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
],
"title": "listPersonsResponse200"
}
DealsMarkAsDeletedResponse
{
"type": "object",
"title": "deleteDealResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal that was deleted"
}
}
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
}
}
}
DealsMergeDealsRequest
{
"type": "object",
"title": "mergeDealsRequest",
"required": [
"merge_with_id"
],
"properties": {
"merge_with_id": {
"type": "integer",
"description": "The ID of the deal that the deal will be merged with"
}
}
}
DealsMergeDealsResponse
{
"type": "object",
"title": "mergeDealsResponse200",
"properties": {
"data": {
"allOf": [
{
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
},
"user_id": {
"type": "integer",
"description": "The ID of the user"
},
"person_id": {
"type": "integer",
"description": "The ID of the person associated with the deal"
},
"creator_user_id": {
"type": "integer",
"description": "The ID of the deal creator"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealStrict"
},
{
"type": "object",
"properties": {
"merge_what_id": {
"type": "integer",
"description": "The deal ID of the deal which the original deal was merged with"
}
}
}
]
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsRemoveFollowerResponse
{
"type": "object",
"title": "deleteDealFollowerResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal follower that was deleted"
}
}
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
}
}
}
DealsSearchByTitleAndNotesResponse
{
"allOf": [
{
"type": "object",
"title": "baseResponse",
"properties": {
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
},
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"type": {
"type": "string",
"description": "The type of the item"
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of notes"
},
"owner": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the owner of the deal"
}
}
},
"stage": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the stage of the deal"
},
"name": {
"type": "string",
"description": "The name of the stage of the deal"
}
}
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "integer",
"description": "The value of the deal"
},
"person": {
"type": "object",
"nullable": true,
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person the deal is associated with"
},
"name": {
"type": "string",
"description": "The name of the person the deal is associated with"
}
}
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"currency": {
"type": "string",
"description": "The currency of the deal"
},
"visible_to": {
"type": "integer",
"description": "The visibility of the deal"
},
"organization": {
"type": "object",
"nullable": true,
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization the deal is associated with"
},
"name": {
"type": "string",
"description": "The name of the organization the deal is associated with"
}
}
},
"custom_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Custom fields"
}
}
},
"result_score": {
"type": "number",
"description": "Search result relevancy"
}
}
},
"description": "The array of deals"
}
}
},
"additional_data": {
"type": "object",
"properties": {
"pagination": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Items shown per page"
},
"start": {
"type": "integer",
"description": "Pagination start"
},
"next_start": {
"type": "integer",
"description": "Next pagination start"
},
"more_items_in_collection": {
"type": "boolean",
"description": "Whether there are more list items in the collection than displayed"
}
},
"description": "Pagination details of the list"
}
}
}
}
}
],
"title": "searchDealsResponse200"
}
DealsUpdateProductAttachmentRequest
{
"type": "object",
"title": "UpdateDealProductRequest",
"properties": {
"tax": {
"type": "number",
"default": 0,
"description": "The tax percentage"
},
"comments": {
"type": "string",
"description": "A textual comment associated with this product-deal attachment"
},
"discount": {
"type": "number",
"default": 0,
"description": "The value of the discount. The `discount_type` field can be used to specify whether the value is an amount or a percentage."
},
"duration": {
"type": "number",
"default": 1,
"description": "The duration of the product"
},
"quantity": {
"type": "integer",
"description": "How many items of this product will be added to the deal"
},
"item_price": {
"type": "number",
"description": "The price at which this product will be added to the deal"
},
"product_id": {
"type": "integer",
"description": "The ID of the product to use"
},
"tax_method": {
"enum": [
"exclusive",
"inclusive",
"none"
],
"type": "string",
"description": "The tax option to be applied to the products. When using `inclusive`, the tax percentage will already be included in the price. When using `exclusive`, the tax will not be included in the price. When using `none`, no tax will be added. Use the `tax` field for defining the tax percentage amount."
},
"enabled_flag": {
"type": "boolean",
"default": true,
"description": "Whether the product is enabled for a deal or not. This makes it possible to add products to a deal with a specific price and discount criteria, but keep them disabled, which refrains them from being included in the deal value calculation. When omitted, the product will be marked as enabled by default."
},
"discount_type": {
"enum": [
"percentage",
"amount"
],
"type": "string",
"default": "percentage",
"description": "The type of the discount's value."
},
"duration_unit": {
"type": "string",
"allOf": [
{
"enum": [
"hourly",
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string",
"title": "dealProductUnitDuration"
}
],
"description": "The unit duration of the product"
},
"product_variation_id": {
"type": "integer",
"description": "The ID of the product variation to use. When omitted, no variation will be used."
}
}
}
DealsUpdateProductAttachmentResponse
{
"type": "object",
"title": "getProductAttachementResponse200",
"properties": {
"data": {
"allOf": [
{
"allOf": [
{
"type": "object",
"title": "basicDealProductRequest",
"required": [
"product_id",
"item_price",
"quantity"
],
"properties": {
"tax": {
"type": "number",
"default": 0,
"description": "The tax percentage"
},
"comments": {
"type": "string",
"description": "A textual comment associated with this product-deal attachment"
},
"discount": {
"type": "number",
"default": 0,
"description": "The value of the discount. The `discount_type` field can be used to specify whether the value is an amount or a percentage."
},
"duration": {
"type": "number",
"default": 1,
"description": "The duration of the product. If omitted, will be set to 1."
},
"quantity": {
"type": "integer",
"description": "Quantity – e.g. how many items of this product will be added to the deal"
},
"item_price": {
"type": "number",
"description": "The price at which this product will be added to the deal"
},
"product_id": {
"type": "integer",
"description": "The ID of the product to use"
},
"tax_method": {
"enum": [
"exclusive",
"inclusive",
"none"
],
"type": "string",
"description": "The tax option to be applied to the products. When using `inclusive`, the tax percentage will already be included in the price. When using `exclusive`, the tax will not be included in the price. When using `none`, no tax will be added. Use the `tax` field for defining the tax percentage amount. By default, the user setting value for tax options will be used. Changing this in one product affects the rest of the products attached to the deal."
},
"enabled_flag": {
"type": "boolean",
"default": true,
"description": "Whether the product is enabled for a deal or not. This makes it possible to add products to a deal with a specific price and discount criteria, but keep them disabled, which refrains them from being included in the deal value calculation. When omitted, the product will be marked as enabled by default."
},
"discount_type": {
"enum": [
"percentage",
"amount"
],
"type": "string",
"default": "percentage",
"description": "The type of the discount's value."
},
"duration_unit": {
"type": "string",
"allOf": [
{
"enum": [
"hourly",
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string",
"title": "dealProductUnitDuration"
}
],
"description": "The unit duration of the product"
},
"product_variation_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the product variation to use. When omitted, no variation will be used."
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal-product (the ID of the product attached to the deal)"
},
"sum": {
"type": "number",
"description": "The sum of all the products attached to the deal"
},
"tax": {
"type": "number",
"description": "The product tax"
},
"name": {
"type": "string",
"description": "The product name"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal"
},
"add_time": {
"type": "string",
"description": "The date and time when the product was added to the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal product"
},
"last_edit": {
"type": "string",
"description": "The date and time when the deal product was last edited"
},
"company_id": {
"type": "integer",
"description": "The ID of the company"
},
"product_id": {
"type": "integer",
"description": "The ID of the product"
},
"active_flag": {
"type": "boolean",
"description": "Whether the product is active or not"
},
"duration_unit": {
"type": "string",
"description": "The type of the duration. (For example hourly, daily, etc.)"
}
}
}
]
}
],
"description": "The updated product object attached to the deal"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
}
}
}
DealsUpdatePropertiesRequest
{
"type": "object",
"allOf": [
{
"type": "object",
"title": "dealTitleParam",
"properties": {
"title": {
"type": "string",
"description": "The title of the deal"
}
}
},
{
"type": "object",
"title": "updateDealParameters",
"properties": {
"label": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Array of the deal labels IDs."
},
"value": {
"type": "string",
"description": "The value of the deal."
},
"org_id": {
"type": "integer",
"description": "The ID of an organization which this deal will be linked to. If the organization does not exist yet, it needs to be created first."
},
"status": {
"enum": [
"open",
"won",
"lost",
"deleted"
],
"type": "string",
"description": "open = Open, won = Won, lost = Lost, deleted = Deleted."
},
"user_id": {
"type": "integer",
"description": "The ID of the user which will be the new owner of the deal."
},
"currency": {
"type": "string",
"description": "The currency of the deal. Accepts a 3-character currency code."
},
"stage_id": {
"type": "integer",
"description": "The ID of the stage this deal will be added to. Please note that a pipeline will be assigned automatically based on the `stage_id`."
},
"person_id": {
"type": "integer",
"description": "The ID of a person which this deal will be linked to. If the person does not exist yet, it needs to be created first."
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline this deal will be added to. By default, the deal will be added to the first stage of the specified pipeline. Please note that `pipeline_id` and `stage_id` should not be used together as `pipeline_id` will be ignored."
}
}
},
{
"type": "object",
"title": "basicDeal",
"properties": {
"won_time": {
"type": "string",
"description": "The optional date and time of changing the deal status as won in UTC. Format: YYYY-MM-DD HH:MM:SS. Can be set only when deal `status` is already Won. Can not be used together with `lost_time`."
},
"lost_time": {
"type": "string",
"description": "The optional date and time of changing the deal status as lost in UTC. Format: YYYY-MM-DD HH:MM:SS. Can be set only when deal `status` is already Lost. Can not be used together with `won_time`."
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The optional date and time of closing the deal in UTC. Format: YYYY-MM-DD HH:MM:SS."
},
"visible_to": {
"type": "string",
"allOf": [
{
"enum": [
"1",
"3",
"5",
"7"
],
"type": "string"
}
],
"description": "The visibility of the deal. If omitted, the visibility will be set to the default visibility setting of this item type for the authorized user. Read more about visibility groups <a href=\"https://support.pipedrive.com/en/article/visibility-groups\" target=\"_blank\" rel=\"noopener noreferrer\">here</a>.<h4>Essential / Advanced plan</h4><table><tr><th style=\"width:40px\">Value</th><th>Description</th></tr><tr><td>`1`</td><td>Owner & followers</td><tr><td>`3`</td><td>Entire company</td></tr></table><h4>Professional / Enterprise plan</h4><table><tr><th style=\"width:40px\">Value</th><th>Description</th></tr><tr><td>`1`</td><td>Owner only</td><tr><td>`3`</td><td>Owner's visibility group</td></tr><tr><td>`5`</td><td>Owner's visibility group and sub-groups</td></tr><tr><td>`7`</td><td>Entire company</td></tr></table>"
},
"lost_reason": {
"type": "string",
"description": "The optional message about why the deal was lost (to be used when status = lost)"
},
"probability": {
"type": "number",
"description": "The success probability percentage of the deal. Used/shown only when `deal_probability` for the pipeline of the deal is enabled."
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal. In ISO 8601 format: YYYY-MM-DD."
}
}
}
],
"title": "updateDealRequest"
}
DealsUpdatePropertiesResponse
{
"type": "object",
"title": "dealResponse200",
"properties": {
"data": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal"
},
"org_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"address": {
"type": "string",
"description": "The address of the organization that is associated with the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the deal"
}
},
"description": "The organization which is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the organization associated with the deal"
}
}
}
],
"title": "dealOrganizationDataWithId"
},
"user_id": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "boolean",
"description": "If the user has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
},
"description": "The user who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the user"
}
}
}
],
"title": "dealUserDataWithId"
},
"person_id": {
"allOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "If this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the deal"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the deal"
},
"primary": {
"type": "boolean",
"description": "If this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the deal"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the deal"
},
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
},
"description": "The person who is associated with the deal"
},
{
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "The ID of the person associated with the deal"
}
}
}
],
"title": "dealPersonDataWithId"
},
"creator_user_id": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the deal creator"
},
"name": {
"type": "string",
"description": "The name of the deal creator"
},
"email": {
"type": "string",
"description": "The email of the deal creator"
},
"value": {
"type": "integer",
"description": "The ID of the deal creator"
},
"has_pic": {
"type": "boolean",
"description": "If the creator has a picture or not"
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The creator picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the creator is active or not"
}
},
"description": "The creator of the deal"
}
}
},
{
"type": "object",
"title": "baseDeal",
"properties": {
"label": {
"type": "string",
"description": "The label or multiple labels assigned to the deal"
},
"title": {
"type": "string",
"description": "The title of the deal"
},
"value": {
"type": "number",
"description": "The value of the deal"
},
"active": {
"type": "boolean",
"description": "Whether the deal is active or not"
},
"status": {
"type": "string",
"description": "The status of the deal"
},
"deleted": {
"type": "boolean",
"description": "Whether the deal is deleted or not"
},
"add_time": {
"type": "string",
"description": "The creation date and time of the deal"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the deal"
},
"currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the deal"
},
"stage_id": {
"type": "integer",
"description": "The ID of the deal stage"
},
"won_time": {
"type": "string",
"description": "The date and time of changing the deal status as won"
},
"lost_time": {
"type": "string",
"description": "The date and time of changing the deal status as lost"
},
"close_time": {
"type": "string",
"nullable": true,
"description": "The date and time of closing the deal"
},
"org_hidden": {
"type": "boolean",
"description": "If the organization that is associated with the deal is hidden or not"
},
"owner_name": {
"type": "string",
"description": "The name of the deal owner"
},
"visible_to": {
"type": "string",
"description": "The visibility of the deal"
},
"files_count": {
"type": "integer",
"description": "The number of files associated with the deal"
},
"lost_reason": {
"type": "string",
"nullable": true,
"description": "The reason for losing the deal"
},
"notes_count": {
"type": "integer",
"description": "The number of notes associated with the deal"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the deal"
},
"pipeline_id": {
"type": "integer",
"description": "The ID of the pipeline associated with the deal"
},
"probability": {
"type": "number",
"nullable": true,
"description": "The success probability percentage of the deal"
},
"rotten_time": {
"type": "string",
"nullable": true,
"description": "The date and time of changing the deal status as rotten"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the deal"
},
"person_hidden": {
"type": "boolean",
"description": "If the person that is associated with the deal is hidden or not"
},
"first_won_time": {
"type": "string",
"description": "The date and time of the first time changing the deal status as won"
},
"products_count": {
"type": "integer",
"description": "The number of products associated with the deal"
},
"stage_order_nr": {
"type": "integer",
"description": "The order number of the deal stage associated with the deal"
},
"weighted_value": {
"type": "number",
"description": "Probability times deal value. Probability can either be deal probability or if not set, then stage probability."
},
"followers_count": {
"type": "integer",
"description": "The number of followers associated with the deal"
},
"formatted_value": {
"type": "string",
"description": "The deal value formatted with selected currency. E.g. US$500"
},
"activities_count": {
"type": "integer",
"description": "The number of activities associated with the deal"
},
"last_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the last activity associated with the deal"
},
"next_activity_id": {
"type": "integer",
"nullable": true,
"description": "The ID of the next activity associated with the deal"
},
"stage_change_time": {
"type": "string",
"description": "The last updated date and time of the deal stage"
},
"last_activity_date": {
"type": "string",
"nullable": true,
"description": "The date of the last activity associated with the deal"
},
"next_activity_date": {
"type": "string",
"description": "The date of the next activity associated with the deal"
},
"next_activity_note": {
"type": "string",
"description": "The note of the next activity associated with the deal"
},
"next_activity_time": {
"type": "string",
"description": "The time of the next activity associated with the deal"
},
"next_activity_type": {
"type": "string",
"description": "The type of the next activity associated with the deal"
},
"participants_count": {
"type": "integer",
"description": "The number of participants associated with the deal"
},
"expected_close_date": {
"type": "string",
"format": "date",
"description": "The expected close date of the deal"
},
"email_messages_count": {
"type": "integer",
"description": "The number of emails associated with the deal"
},
"done_activities_count": {
"type": "integer",
"description": "The number of completed activities associated with the deal"
},
"next_activity_subject": {
"type": "string",
"description": "The subject of the next activity associated with the deal"
},
"next_activity_duration": {
"type": "string",
"description": "The duration of the next activity associated with the deal"
},
"last_incoming_mail_time": {
"type": "string",
"description": "The date and time of the last incoming email associated with the deal"
},
"last_outgoing_mail_time": {
"type": "string",
"description": "The date and time of the last outgoing email associated with the deal"
},
"undone_activities_count": {
"type": "integer",
"description": "The number of incomplete activities associated with the deal"
},
"weighted_value_currency": {
"type": "string",
"description": "The currency associated with the deal"
},
"formatted_weighted_value": {
"type": "string",
"description": "The weighted_value formatted with selected currency. E.g. US$500"
}
}
}
],
"title": "dealNonStrict"
},
"success": {
"type": "boolean",
"description": "If the response is successful or not"
},
"related_objects": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"USER_ID": {
"type": "object",
"allOf": [
{
"properties": {
"id": {
"type": "integer",
"description": "The ID of the user"
},
"name": {
"type": "string",
"description": "The name of the user"
},
"email": {
"type": "string",
"description": "The email of the user"
},
"has_pic": {
"type": "integer",
"description": "Whether the user has picture or not. 0 = No picture, 1 = Has picture."
},
"pic_hash": {
"type": "string",
"nullable": true,
"description": "The user picture hash"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not"
}
}
},
{
"type": "object",
"description": "The ID of the user"
}
],
"title": "userDataWithId"
}
}
},
"person": {
"type": "object",
"properties": {
"PERSON_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated person is active or not"
}
}
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the person associated with the item"
},
"name": {
"type": "string",
"description": "The name of the person associated with the item"
},
"email": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the email"
},
"value": {
"type": "string",
"description": "The email of the associated person"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary email or not"
}
}
},
"description": "The emails of the person associated with the item"
},
"phone": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The type of the phone number"
},
"value": {
"type": "string",
"description": "The phone number of the person associated with the item"
},
"primary": {
"type": "boolean",
"description": "Whether this is the primary phone number or not"
}
}
},
"description": "The phone numbers of the person associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the person that is associated with the item"
}
}
}
],
"description": "The ID of the person associated with the item"
}
}
},
"organization": {
"type": "object",
"properties": {
"ORGANIZATION_ID": {
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"active_flag": {
"type": "boolean",
"description": "Whether the associated organization is active or not"
}
}
},
{
"type": "object",
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the organization associated with the item"
}
}
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the organization associated with the item"
},
"address": {
"type": "string",
"description": "The address of the organization"
},
"cc_email": {
"type": "string",
"description": "The BCC email of the organization associated with the item"
},
"owner_id": {
"type": "integer",
"description": "The ID of the owner of the organization that is associated with the item"
},
"people_count": {
"type": "integer",
"description": "The number of people connected with the organization that is associated with the item"
}
}
}
],
"description": "The ID of the organization associated with the item"
}
],
"description": "The ID of the organization associated with the item"
}
}
}
}
}
}
}
FilesCreateRemoteFileAndLinkRequest
{
"type": "object",
"title": "addFileAndLinkItRequest",
"required": [
"file_type",
"title",
"item_type",
"item_id",
"remote_location"
],
"properties": {
"title": {
"type": "string",
"description": "The title of the file"
},
"item_id": {
"type": "integer",
"description": "The ID of the item to associate the file with"
},
"file_type": {
"enum": [
"gdoc",
"gslides",
"gsheet",
"gform",
"gdraw"
],
"type": "string",
"description": "The file type"
},
"item_type": {
"enum": [
"deal",
"organization",
"person"
],
"type": "string",
"description": "The item type"
},
"remote_location": {
"enum": [
"googledrive"
],
"type": "string",
"description": "The location type to send the file to. Only `googledrive` is supported at the moment."
}
}
}
FilesCreateRemoteFileAndLinkResponse
{
"type": "object",
"title": "addFileAndLinkItResponse200",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the file"
},
"cid": {
"type": "string",
"description": "The ID of the inline attachment"
},
"url": {
"type": "string",
"description": "The URL of the download file"
},
"name": {
"type": "string",
"description": "The visible name of the file"
},
"org_id": {
"type": "integer",
"description": "The ID of the organization to associate the file with"
},
"deal_id": {
"type": "integer",
"description": "The ID of the deal to associate the file with"
},
"lead_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the lead to associate the file with"
},
"user_id": {
"type": "integer",
"description": "The ID of the user to associate the file with"
},
"add_time": {
"type": "string",
"description": "The date and time when the file was added/created. Format: YYYY-MM-DD HH:MM:SS"
},
"org_name": {
"type": "string",
"description": "The name of the organization associated with the file"
},
"deal_name": {
"type": "string",
"description": "The name of the deal associated with the file"
},
"file_name": {
"type": "string",
"description": "The original name of the file"
},
"file_size": {
"type": "integer",
"description": "The size of the file"
},
"lead_name": {
"type": "string",
"description": "The name of the lead associated with the file"
},
"person_id": {
"type": "integer",
"description": "The ID of the person to associate the file with"
},
"remote_id": {
"type": "string",
"description": "The ID of the remote item"
},
"s3_bucket": {
"type": "string",
"description": "The location of the cloud storage"
},
"product_id": {
"type": "integer",
"description": "The ID of the product to associate the file with"
},
"active_flag": {
"type": "boolean",
"description": "Whether the user is active or not. false = Not activated, true = Activated"
},
"activity_id": {
"type": "integer",
"description": "The ID of the activity to associate the file with"
},
"description": {
"type": "string",
"description": "The description of the file"
},
"inline_flag": {
"type": "boolean",
"description": "Whether the file was uploaded as inline or not"
},
"person_name": {
"type": "string",
"description": "The name of the person associated with the file"
},
"update_time": {
"type": "string",
"description": "The last updated date and time of the file. Format: YYYY-MM-DD HH:MM:SS"
},
"product_name": {
"type": "string",
"description": "The name of the product associated with the file"
},
"mail_message_id": {
"type": "string",
"description": "The ID of the mail message to associate the file with"
},
"remote_location": {
"type": "string",
"description": "The location type to send the file to. Only googledrive is supported at the moment."
},
"mail_template_id": {
"type": "string",
"description": "The ID of the mail template to associate the file with"
}
},
"description": "The file data"
},
"success": {
"type": "boolean",
"description": "If the request was successful or not"
}
}
}
FilesDownloadFileResponse
{
"type": "string",
"title": "downloadFileResponse200",
"format": "byte"
}