POST Agents/Person/GetSalesRep
Some tooltip text!
• 16 minutes to read
• 16 minutes to read
POST /api/v1/Agents/Person/GetSalesRep
Returns the sales representative for an external user.
If this method is accessed with anonymous authentication the external user is recognized by contact and name, or by email, or phone number. If the external user is recognized as an CRM5 user (internal or external) the input fields can be left blank. NsApiSlow threshold: 2000 ms.
Query String Parameters
| Parameter Name | Type | Description |
|---|---|---|
| $select | string | Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields. |
POST /api/v1/Agents/Person/GetSalesRep?$select=name,department,category/id
Request Headers
| Parameter Name | Description |
|---|---|
| Authorization | Supports 'Basic', 'SoTicket' and 'Bearer' schemes, depending on installation type. |
| X-XSRF-TOKEN | If not using Authorization header, you must provide XSRF value from cookie or hidden input field |
| Content-Type | Content-type of the request body: application/json, text/json, application/xml, text/xml, application/x-www-form-urlencoded, application/json-patch+json, application/merge-patch+json |
| Accept | Content-type(s) you would like the response in: application/json, text/json, application/xml, text/xml, application/json-patch+json, application/merge-patch+json |
| Accept-Language | Convert string references and multi-language values into a specified language (iso2) code. |
| SO-Language | Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value. |
| SO-Culture | Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set. |
| SO-TimeZone | Specify the timezone code that you would like date/time responses converted to. |
| SO-AppToken | The application token that identifies the partner app. Used when calling Online WebAPI from a server. |
Request Body: request
ContactName, PersonFirstname, PersonLastname, EmailAddress, PhoneNumber
| Property Name | Type | Description |
|---|---|---|
| ContactName | String | |
| PersonFirstname | String | |
| PersonLastname | String | |
| EmailAddress | String | |
| PhoneNumber | String |
Response:
OK
| Response | Description |
|---|---|
| 200 | OK |
Response body: PersonEntity
| Property Name | Type | Description |
|---|---|---|
| PersonId | int32 | Primary key |
| Firstname | string | First name |
| MiddleName | string | Middle name or 'van' etc. |
| Lastname | string | Last name |
| Mrmrs | string | e.g. Mrs sex_title Use MDO List name "mrmrs" to get list items. |
| Title | string | Title |
| UpdatedDate | date-time | Last updated date in UTC. |
| CreatedDate | date-time | Registered date in UTC. |
| BirthDate | date-time | The Person birth date as UTC Date. Year 1 = Null. Year 2 = unknown year. |
| CreatedBy | Associate | The user that created the person object |
| Emails | array | A collection of the person's emails |
| Description | string | The actual text, max 2047 significant characters even though it is stored as a larger data type on some databases |
| IsAssociate | bool | Checks if the person object is an associate. The property is read-only. |
| PrivatePhones | array | Returns a collection of phone numbers that belong to the contact person. |
| Faxes | array | Returns a collection of fax numbers that belong to the contact person. |
| MobilePhones | array | Returns a collection of mobile phone numbers that belong to the contact person. |
| OfficePhones | array | Returns a collection of office phone numbers that belong to the contact person. |
| OtherPhones | array | Returns a collection of pagers that belong to the contact person. |
| Position | Position | The position. This is a predefined SuperOffice value, different from Title Use MDO List name "perspos" to get list items. |
| UpdatedBy | Associate | The person that last updated the person object |
| Contact | Contact | The contact the contact person is registered on. This is required unless the 'MandatoryContactOnPerson' preference is set. Use MDO List name "contact_new" to get list items. |
| Country | Country | The country this contact person is located in. Use MDO List name "country" to get list items. |
| Interests | array | The person's available and selected interests. Use MDO List name "persint" to get list items. |
| PersonNumber | string | Alphanumeric user field |
| FullName | string | The person's full name localized to the current culture/country. (internal name used in clients for employees) |
| NoMailing | bool | Spam filter. Indicates if this person should retrieve advertising. |
| UsePersonAddress | bool | True if the person's address should be used as mailing address, instead of the contact's address. |
| Retired | bool | True if the user is retired and should have no rights, not appear in lists, etc. |
| Urls | array | The urls related to this person. |
| FormalName | string | Get formal name for a person, as used in labels. (Full name + person title + academic title) |
| Address | Address | Structure holding formatted address data. The layout of the array structure indicates the layout of the localized address. |
| Post3 | string | Postal address, used in Japanese versions only |
| Post2 | string | Postal address, used in Japanese versions only |
| Post1 | string | Postal address, used in Japanese versions only |
| Kanalname | string | Kana last name, used in Japanese versions only |
| Kanafname | string | Kana first name, used in Japanese versions only |
| CorrespondingAssociate | Associate | The associate corresponding to this person. Will be empty if the person is not a user (internal associate user, external user). |
| Category | Category | Person's category. Usually null. Refer to the Contact.Category instead. Intended for use when individual persons are created. (i.e. when Person.Contact is blank) Use MDO List name "category" to get list items. |
| Business | Business | Person's business - usually blank. Use Contact.Business instead. Intended for use when individual persons are created. (i.e. when Person.Contact is blank) Use MDO List name "business" to get list items. |
| Associate | Associate | The associate owning this person (similar to contact.Associate) - usually blank. Use the Person.Contact.Associate instead. Intended for use when individual persons are created (i.e. when Person.Contact is blank) Use MDO List name "associate" to get list items. |
| Salutation | string | Academic title, populated from Salutation list but can be overwritten with anything at all Use MDO List name "salutation" to get list items. |
| ActiveInterests | int32 | The number of active interests. |
| SupportAssociate | Associate | Use MDO List name "associate" to get list items. |
| TicketPriority | TicketPriority | Use MDO List name "ticketpriority" to get list items. |
| CustomerLanguage | CustomerLanguage | Use MDO List name "customerlanguage" to get list items. |
| DbiAgentId | int32 | Integration agent (eJournal) |
| DbiKey | string | The primary key for the integrated entry in the external datasource. |
| DbiLastModified | date-time | When the entry was last modified. |
| DbiLastSyncronized | date-time | Last external syncronization. |
| SentInfo | int32 | Has information on username/password been sent (ejournal) |
| ShowContactTickets | int32 | Should tickets related to the company be shown to this person |
| UserInfo | UserInfo | Information about the user if this person is a user. If IsAssociate (e.g. is user is true) the UserInfo will be provided. |
| ChatEmails | array | |
| InternetPhones | array | |
| Source | int32 | How did we get this person? For future integration needs |
| ActiveErpLinks | int32 | How many active ERP links are there for this person? |
| ShipmentTypes | array | The person's available and selected shipment types. |
| Consents | array | The person's available consent information. Missing consents are not deleted. To remove a consent, mark its legalbase as 'WITHDRAWN' |
| BounceEmails | array | Email addresses with a positive bounce counter. |
| ActiveStatusMonitorId | int32 | Active status monitor identity with the lowest rank for person |
| CreatedByFormId | int32 | The form id of the form that created the person |
| UtmParameters | SavedUtmParameters | Utm parameters when creating this person, readonly fields |
| LeadstatusId | int32 | Refinement of categories of lead type. Empty if the category is not a lead type. |
| UserDefinedFields | object | Deprecated: Use {SuperOffice.CRM.Services.PersonEntity.CustomFields} instead. Dictionary of user defined field data. The key string is the ProgId of the UdefField, or if the ProgId is empty it is a string of the format "SuperOffice:[UdefFieldIdentity]", e.g. "SuperOffice:1234" |
| ExtraFields | object | Deprecated: Use {SuperOffice.CRM.Services.PersonEntity.CustomFields} instead. Extra fields added to the carrier. This could be data from Plug-ins, the foreign key system, external applications, etc. |
| CustomFields | object | Udef + Extra fields added to the carrier. Extra fields as defined by changes to database schema + user-defined fields as defined by admin. Custom fields combines user defined fields and extra fields into one bucket. The individual {SuperOffice.CRM.Services.PersonEntity.ExtraFields} and UserDefinedFields properties are deprecated in favor of this combined collection. |
| TableRight | TableRight | The carrier's table right |
| FieldProperties | object | Field property dictionary mapping field names to field access rights. |
Sample request
POST /api/v1/Agents/Person/GetSalesRep
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: fr,de,ru,zh
Content-Type: application/json; charset=utf-8
{
"ContactName": "Pagac-Schuster",
"PersonFirstname": "Lizeth",
"PersonLastname": "Wolf",
"EmailAddress": "cara@okeefe.com",
"PhoneNumber": "520569"
}
Sample response
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"PersonId": 604,
"Firstname": "Verona",
"MiddleName": "Waelchi, Bode and Jacobson",
"Lastname": "Jakubowski",
"Mrmrs": "molestiae",
"Title": "vero",
"UpdatedDate": "2017-10-18T02:30:47.5225762+02:00",
"CreatedDate": "2020-12-27T02:30:47.5225762+01:00",
"BirthDate": "2019-11-17T02:30:47.5225762+01:00",
"CreatedBy": null,
"Emails": [
{
"Value": "eos",
"StrippedValue": "doloribus",
"Description": "Universal next generation process improvement",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 597
}
}
},
{
"Value": "eos",
"StrippedValue": "doloribus",
"Description": "Universal next generation process improvement",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 597
}
}
}
],
"Description": "Assimilated foreground support",
"IsAssociate": false,
"PrivatePhones": [
{
"Value": "facere",
"StrippedValue": "ut",
"Description": "Optional 5th generation orchestration",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.String",
"FieldLength": 887
}
}
},
{
"Value": "facere",
"StrippedValue": "ut",
"Description": "Optional 5th generation orchestration",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.String",
"FieldLength": 887
}
}
}
],
"Faxes": [
{
"Value": "quas",
"StrippedValue": "ipsum",
"Description": "Optimized intermediate parallelism",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 553
}
}
},
{
"Value": "quas",
"StrippedValue": "ipsum",
"Description": "Optimized intermediate parallelism",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 553
}
}
}
],
"MobilePhones": [
{
"Value": "commodi",
"StrippedValue": "vitae",
"Description": "De-engineered cohesive frame",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 978
}
}
},
{
"Value": "commodi",
"StrippedValue": "vitae",
"Description": "De-engineered cohesive frame",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 978
}
}
}
],
"OfficePhones": [
{
"Value": "eum",
"StrippedValue": "sapiente",
"Description": "Enhanced client-server middleware",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 746
}
}
},
{
"Value": "eum",
"StrippedValue": "sapiente",
"Description": "Enhanced client-server middleware",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 746
}
}
}
],
"OtherPhones": [
{
"Value": "officiis",
"StrippedValue": "nemo",
"Description": "Versatile client-server superstructure",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.String",
"FieldLength": 612
}
}
},
{
"Value": "officiis",
"StrippedValue": "nemo",
"Description": "Versatile client-server superstructure",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.String",
"FieldLength": 612
}
}
}
],
"Position": null,
"UpdatedBy": null,
"Contact": null,
"Country": null,
"Interests": [
{
"Id": 423,
"Name": "Keebler-Haag",
"ToolTip": "Iusto accusamus consequatur deserunt qui.",
"Deleted": false,
"Rank": 22,
"Type": "itaque",
"ColorBlock": 117,
"IconHint": "quis",
"Selected": true,
"LastChanged": "2001-09-16T02:30:47.5225762+02:00",
"ChildItems": [
{},
{}
],
"ExtraInfo": "dolorem",
"StyleHint": "vero",
"Hidden": false,
"FullName": "Conor Francesco Hessel DVM",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 872
}
}
}
],
"PersonNumber": "1122295",
"FullName": "Dawn Haag",
"NoMailing": true,
"UsePersonAddress": false,
"Retired": false,
"Urls": [
{
"Value": "facere",
"StrippedValue": "beatae",
"Description": "Reduced systematic encoding",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 411
}
}
},
{
"Value": "facere",
"StrippedValue": "beatae",
"Description": "Reduced systematic encoding",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 411
}
}
}
],
"FormalName": "Koepp, Emard and Rath",
"Address": null,
"Post3": "consequuntur",
"Post2": "ut",
"Post1": "et",
"Kanalname": "praesentium",
"Kanafname": "numquam",
"CorrespondingAssociate": null,
"Category": null,
"Business": null,
"Associate": null,
"Salutation": "pariatur",
"ActiveInterests": 680,
"SupportAssociate": null,
"TicketPriority": null,
"CustomerLanguage": null,
"DbiAgentId": 600,
"DbiKey": "beatae",
"DbiLastModified": "2019-07-30T02:30:47.5225762+02:00",
"DbiLastSyncronized": "2011-12-02T02:30:47.5225762+01:00",
"SentInfo": 855,
"ShowContactTickets": 243,
"UserInfo": null,
"ChatEmails": [
{
"Value": "et",
"StrippedValue": "alias",
"Description": "De-engineered bandwidth-monitored projection",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 495
}
}
},
{
"Value": "et",
"StrippedValue": "alias",
"Description": "De-engineered bandwidth-monitored projection",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 495
}
}
}
],
"InternetPhones": [
{
"Value": "porro",
"StrippedValue": "distinctio",
"Description": "Monitored analyzing focus group",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 370
}
}
},
{
"Value": "porro",
"StrippedValue": "distinctio",
"Description": "Monitored analyzing focus group",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 370
}
}
}
],
"Source": 813,
"ActiveErpLinks": 418,
"ShipmentTypes": [
{
"Id": 958,
"Name": "Upton, Monahan and Abernathy",
"ToolTip": "Repellendus consectetur.",
"Deleted": true,
"Rank": 172,
"Type": "illum",
"ColorBlock": 914,
"IconHint": "iure",
"Selected": true,
"LastChanged": "2015-05-05T02:30:47.5225762+02:00",
"ChildItems": [
{},
{}
],
"ExtraInfo": "illum",
"StyleHint": "rerum",
"Hidden": false,
"FullName": "Triston Shanahan",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 427
}
}
}
],
"Consents": [
{
"ConsentPersonId": 452,
"Comment": "autem",
"Registered": "2005-03-26T02:30:47.5225762+01:00",
"RegisteredAssociateId": 252,
"Updated": "2021-07-23T02:30:47.5225762+02:00",
"UpdatedAssociateId": 724,
"LegalBaseId": 863,
"LegalBaseKey": "ullam",
"LegalBaseName": "Turcotte Group",
"ConsentPurposeId": 146,
"ConsentPurposeKey": "dolore",
"ConsentPurposeName": "Smitham Inc and Sons",
"ConsentSourceId": 274,
"ConsentSourceKey": "magnam",
"ConsentSourceName": "Greenfelder, Jenkins and Walter",
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.Int32",
"FieldLength": 741
}
}
}
],
"BounceEmails": [
"barton@jenkins.name",
"arch@kovacek.us"
],
"ActiveStatusMonitorId": 250,
"CreatedByFormId": 774,
"UtmParameters": null,
"LeadstatusId": 203,
"UserDefinedFields": {
"SuperOffice:1": "689211463",
"SuperOffice:2": "Griffin Swift"
},
"ExtraFields": {
"ExtraFields1": "error",
"ExtraFields2": "inventore"
},
"CustomFields": {
"CustomFields1": "ea",
"CustomFields2": "molestiae"
},
"TableRight": null,
"FieldProperties": {
"fieldName": {
"FieldRight": null,
"FieldType": "System.String",
"FieldLength": 970
}
}
}