Objects

Retrieve a contact

Retrieve a single contact by contact ID.

Overview

Use this endpoint to read one contact record. You can limit the returned property set with the properties query parameter and include associations when needed. It requires public api oauth access token authentication and the crm.contacts.read scope.

GET/api/crm/objects/contacts/{contactId}

cURL

GET

bash

curl --request GET \  --url 'https://crm.notifyy.io/api/crm/objects/contacts/55?properties=firstname%2Ctags&associations=company%2Cdeal' \  --header 'Authorization: Bearer nfy_public_api_access_token'

Authorization

Public API OAuth access token

crm.contacts.read

Sample Request Body

This endpoint does not require a request body.

Sample Response

json

{  "success": true,  "message": "Contact retrieved successfully",  "data": {    "id": 55,    "properties": {      "firstname": "Jane",      "tags": [        "vip",        "newsletter"      ]    },    "associations": {      "company": [        {          "id": "456",          "type": "contact_to_company"        }      ],      "deal": [        {          "id": "789",          "type": "deal_to_contact"        }      ]    }  }}

Status Codes

Code	Description
200	Contact was returned.
404	Contact does not exist in the token-bound tenant and project.

Headers

AuthorizationstringRequired

Public API OAuth bearer token.

Example: Bearer nfy_public_api_access_token

Object	Description
Authorization string	RequiredPublic API OAuth bearer token. Example: Bearer nfy_public_api_access_token

Path parameters

contactIdintegerRequired

Contact ID.

Example: 55

Object	Description
contactId integer	RequiredContact ID. Example: 55

Query parameters

propertiesstringOptional

Comma-separated property internal names to return.

Example: firstname,tags

associationsstringOptional

Comma-separated associated object types to include.

Example: company,deal

Object	Description
properties string	OptionalComma-separated property internal names to return. Example: firstname,tags
associations string	OptionalComma-separated associated object types to include. Example: company,deal

Response fields

successboolean

Whether the request succeeded.

Example: true

messagestring

Human-readable result message.

Example: Contact retrieved successfully

data.idinteger

Contact record ID.

Example: 55

data.propertiesobject

Requested contact properties keyed by internal name.

data.associationsobject | null

Associated records grouped by object type when requested.

Object	Description
success boolean	Whether the request succeeded. Example: true
message string	Human-readable result message. Example: Contact retrieved successfully
data.id integer	Contact record ID. Example: 55
data.properties object	Requested contact properties keyed by internal name.
data.associations object \| null	Associated records grouped by object type when requested.