Read Person

When you call Person Service with GET method, you can find people on next4biz CRM.

Your request body must be contain 4 properties.

  • tenant_slug This is your subdomain on selphiu URL. For example: if your selphiu domain is “acme.selpihu.com” then your tenant_slug is “acme”
  • access_token next4biz CRM provide an access_token via access_token service. Every access_token expires after 15 minutes. Best Practice, you request a new access_token for each service request.
  • channel This is bussines channel id. If you don’t know your bussiness_channels and there’s id numbers. You can learn via bussiness_channel service.
  • person This is an array includes objects as person property is an object contain your person search values. Every person object property join as AND operator and every person object JOIN as OR operator.

Hints

You can sent two optional parameters:

  • limit  Number of objects to return. Default is 50 maximum value is 200
  • offset The number from which to start for read. Default is 0
Name Value
REST-API METHOD Read Person
HTTP METHOD GET
RESPONSE TYPE JSON
URL https://api.crm.next4biz.com/custom-field/
REQUEST HEAD Accept: application/json; Content-Type: application/json
ENDPOINT DEFINITION
GET
SAMPLE REQUEST BODY
{
	"tenant_slug": "acme",
	"channel": "555",
	"access_token": "",
	"person": [
		{
			"name": "John",
			"email": "[email protected]"
		},
		{
			"name": "Jane"
		}
	]
}
SAMPLE RESPONSE BODY
{
	"code": "200",
	"status": "Success",
	"result": [
		{
			"person_id": "34196",
			"name": "Jane",
			"mname": null,
			"surname": "Cool",
			"full_name": "Jane Cool",
			"title_text": "CRM Müdürü",
			"resource": "LinkedIn",
			"created_at": "2012-07-20",
			"updated_at": "2015-07-04",
			"linkedin_id": null,
			"linkedin_url": null,
			"citizenship_number": null,
			"create_owner": {
				"user_id": 12,
				"user_name": "scoobe.doo",
				"email": "[email protected]",
				"created_at": "2015-02-23 21:54:55",
				"updated_at": "2016-02-26 12:05:27",
				"lang": "tr",
				"profile_picture": "scoobe-doo.gif"
			},
			"last_update_owner": null,
			"unique_id": null,
			"channel": {
				"channel_id": "555",
				"channel_name": "Acme Global",
				"channel_slug": "acme-global",
				"is_active": true,
				"created_at": "2015-04-04 14:24:59",
				"lang": "tr",
				"is_builtin": true,
				"business_type": 1
			},
			"custom_data": [],
			"default_email": {
				"person_email_id": "34576",
				"email_address": "[email protected]",
				"created_at": null,
				"updated_at": null,
				"is_incorrect": false,
				"person_id": "34196"
			},
			"title": {
				"title_id": 2,
				"title_name": "crmmanager",
				"tenant": {
					"tenant_id": 555,
					"tenant_name": "Acme Company",
					"tenant_slug": "acme",
					"created_at": "2015-02-16 21:15:06"
				}
			}
		}
	]
}