Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
includes
string
No
—
possible includes are: user, attachment_category, comments separated by space. Receive all includes using the ‘all’ value.
methods
string
No
—
Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the ‘all’ value.
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "includes": { "type": "string", "description": "possible includes are: user, attachment_category, comments separated by space. Receive all includes using the 'all' value." }, "methods": { "type": "string", "description": "Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the 'all' value." } }, "required": [ "PCID" ]}
Retrieves attachments matching the searchParameters:
Parameter
Type
Required
Default
Description
filename
string
No
—
find attachments where the filename includes or matches the given input
includes
string
No
—
possible includes are: user, attachment_category, comments separated by space. Receive all includes using the ‘all’ value.
methods
string
No
—
Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the ‘all’ value.
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "filename": { "type": "string", "description": "find attachments where the filename includes or matches the given input" }, "includes": { "type": "string", "description": "possible includes are: user, attachment_category, comments separated by space. Receive all includes using the 'all' value." }, "methods": { "type": "string", "description": "Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the 'all' value." } }, "required": [ "PCID" ]}
Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" } }, "required": [ "PCID" ]}
Retrieves all records matching the contact_details searchParameters:
Parameter
Type
Required
Default
Description
type
string
No
—
Either people or companies whereas people is the default
name
string
Yes
—
Search term
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "type": { "type": "string", "description": "Either people or companies whereas people is the default" }, "name": { "type": "string", "description": "Search term" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" } }, "required": [ "PCID", "name" ]}
Retrieves all CustomFieldTypes of the accountParameters:
Parameter
Type
Required
Default
Description
order
string
No
—
Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" } }, "required": [ "PCID" ]}
Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
includes
string
No
—
possible option: comments
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "includes": { "type": "string", "description": "possible option: comments" } }, "required": [ "PCID" ]}
possible includes are: user, attachment_category, comments separated by space. Receive all includes using the ‘all’ value.
methods
string
No
—
Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the ‘all’ value.
order
string
No
—
Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
external_email_id
integer
Yes
—
External Email Id
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "includes": { "type": "string", "description": "possible includes are: user, attachment_category, comments separated by space. Receive all includes using the 'all' value." }, "methods": { "type": "string", "description": "Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the 'all' value." }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "external_email_id": { "type": "integer", "description": "External Email Id" } }, "required": [ "PCID", "external_email_id" ]}
Retrieves all filter_groups of the accountParameters:
Parameter
Type
Required
Default
Description
order
string
No
—
Ordering of records using one of the following order options: abc-asc, abc-desc, new-asc, new-desc, update-asc, update-desc, activity-asc, activity-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
filter
object
No
—
Optionally submit one of the filtergroups attributes in order to filter by them (e.g. { ‘name’: { ‘equal’: ‘your-value’ } }). Allowed filter modifiers are smaller_than, larger_than, equal, between or in. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. { 'between': '2023-01-01,2023-02-01' }) and in allows a list of comma separated options (e.g. { 'in': '23,42,99' }).
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `abc-asc`, `abc-desc`, `new-asc`, `new-desc`, `update-asc`, `update-desc`, `activity-asc`, `activity-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "filter": { "type": "object", "description": "Optionally submit one of the filtergroups attributes in order to filter by them (e.g. { 'name': { 'equal': 'your-value' } }). Allowed filter modifiers are `smaller_than`, `larger_than`, `equal`, `between` or `in`. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. `{ 'between': '2023-01-01,2023-02-01' }`) and `in` allows a list of comma separated options (e.g. `{ 'in': '23,42,99' }`)." } }, "required": [ "PCID" ]}
Retrieves records matching the filter groupParameters:
Parameter
Type
Required
Default
Description
id
integer
Yes
—
The id value
includes
string
No
—
available includes depend on the model_type of the FilterGroup and can be found in the APIdocs of the object (e.g. Person, Company, Deal or Project. Includes may be separated by space. Receive all includes using the all value.
methods
string
No
—
available methods depend on the model_type of the FilterGroup and can be found in the APIdocs of the object (e.g. Person, Company, Deal or Project. Methods may be separated by space. Receive all methods using the all value.
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "integer", "description": "The id value" }, "includes": { "type": "string", "description": "available includes depend on the model_type of the FilterGroup and can be found in the APIdocs of the object (e.g. `Person`, `Company`, `Deal` or `Project`. Includes may be separated by space. Receive all includes using the `all` value." }, "methods": { "type": "string", "description": "available methods depend on the model_type of the FilterGroup and can be found in the APIdocs of the object (e.g. `Person`, `Company`, `Deal` or `Project`. Methods may be separated by space. Receive all methods using the `all` value." } }, "required": [ "PCID", "id" ]}
Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
includes
string
No
—
possible option: cal_events
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "includes": { "type": "string", "description": "possible option: cal_events" } }, "required": [ "PCID" ]}
Ordering of records using one of the following order options: id-asc, id-desc
perpage
integer
No
—
Elements per page, maximum of 250
page
integer
No
—
Retrieve records of the given page
filter
object
No
—
Optionally submit one of the taggings attributes in order to filter by them (e.g. { ‘name’: { ‘equal’: ‘your-value’ } }). Allowed filter modifiers are smaller_than, larger_than, equal, between or in. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. { 'between': '2023-01-01,2023-02-01' }) and in allows a list of comma separated options (e.g. { 'in': '23,42,99' }).
person_id
integer
No
—
Optional ID of the desired person
company_id
integer
No
—
Optional ID of the desired company
deal_id
integer
No
—
Optional ID of the desired deal
project_id
integer
No
—
Optional ID of the desired project
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "order": { "type": "string", "description": "Ordering of records using one of the following order options: `id-asc`, `id-desc`" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "filter": { "type": "object", "description": "Optionally submit one of the taggings attributes in order to filter by them (e.g. { 'name': { 'equal': 'your-value' } }). Allowed filter modifiers are `smaller_than`, `larger_than`, `equal`, `between` or `in`. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. `{ 'between': '2023-01-01,2023-02-01' }`) and `in` allows a list of comma separated options (e.g. `{ 'in': '23,42,99' }`)." }, "person_id": { "type": "integer", "description": "Optional ID of the desired person" }, "company_id": { "type": "integer", "description": "Optional ID of the desired company" }, "deal_id": { "type": "integer", "description": "Optional ID of the desired deal" }, "project_id": { "type": "integer", "description": "Optional ID of the desired project" } }, "required": [ "PCID" ]}
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" } }, "required": [ "PCID" ]}
optional parameter to only include currently active users
Show inputSchema
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "active": { "type": "string", "description": "optional parameter to only include currently active users" } }, "required": [ "PCID" ]}
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "perpage": { "type": "integer", "description": "Elements per page, maximum of 250" }, "page": { "type": "integer", "description": "Retrieve records of the given page" }, "first": { "type": "string", "description": "Retrieve users by their first name" }, "name": { "type": "string", "description": "Retrieve users by their last name" } }, "required": [ "PCID" ]}
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "group_calendar": { "type": "object", "description": "Group Calendar", "properties": { "read_only": { "type": "boolean", "description": "some calendars will be added on account creation an cannot be removed or renamed" }, "name": { "type": "string", "description": "The name value" }, "color_type": { "type": "string", "description": "can be one of the following: one two three four five six seven eight nine ten eleven twelve" } }, "required": [ "read_only", "name", "color_type" ] } }, "required": [ "PCID" ]}
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "includes": { "type": "string", "description": "possible option: filter_groups" }, "hook": { "type": "object", "description": "The hook value", "properties": { "model": { "type": "string", "description": "Object type to be notified about (either Person, Company, Deal, Project or Protocol)." }, "event": { "type": "string", "description": "Activity that shall trigger the hook (either create, update or destroy)." }, "state": { "type": "string", "description": "Indicating if the hook is enabled or not (either active or disabled)." }, "target_url": { "type": "string", "description": "URL to which the webhook should be sent." }, "object_type": { "type": "string", "description": "Data structure of the webhook (either nested, api or lean)." }, "includes": { "type": "string", "description": "Only relevant for the object_types `nested`, `api` and `hook_with_structure_and_record`. Subrecords may be specified comma-separated and will be included within the webhooks data (e.g. tags, addrs, historic_events ...)." }, "methods": { "type": "array", "description": "Methods depending on the hook model, e.g. `salutation_official` for Person." }, "hook_type": { "type": "string", "description": "We currently only support `url` as hook type." }, "failed": { "type": "integer", "description": "Number of failed attempts to deliver a webhook to the target_url." }, "failed_at": { "type": "string", "description": "The last time a webhook could not be delivered to the target_url." } }, "required": [ "model", "event", "target_url", "object_type", "hook_type" ] } }, "required": [ "PCID" ]}
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "tag": { "type": "object", "description": "The tag value", "properties": { "attachable_id": { "type": "integer", "description": "id of the record the tag belongs to (e.g. a person). Will be auto set when using routes such as /people/:id with nested attributes." }, "attachable_type": { "type": "string", "description": "must be Person, Company, Deal, Company. Will be auto set when using routes such as /people/:id with nested attributes." }, "name": { "type": "string", "description": "The name value" }, "api_input": { "type": "boolean", "description": "States weather or not the tag has been added via the API or some sort of integration." } }, "required": [ "attachable_id", "attachable_type", "name" ] } }, "required": [ "PCID" ]}
{ "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "The id value" }, "group_calendar": { "type": "object", "description": "Group Calendar", "properties": { "read_only": { "type": "boolean", "description": "some calendars will be added on account creation an cannot be removed or renamed" }, "name": { "type": "string", "description": "The name value" }, "color_type": { "type": "string", "description": "can be one of the following: one two three four five six seven eight nine ten eleven twelve" } }, "required": [ "read_only", "name", "color_type" ] } }, "required": [ "PCID", "id" ]}