Contacts API

Get a contact by id

Changed on

The endpoint allows you to retrieve a specific contact by providing its unique contact ID as a path parameter. This endpoint provides a convenient way to fetch detailed information about a particular contact based on its ID.

get/contacts/{contact_id}

Request

  • Base URL
    https://api.talkdeskapp.com
  • URL
    https://api.talkdeskapp.com/contacts/{contact_id}
  • Auth
    OAuth 2
    Authorization code: https://{account_name}.talkdeskid.com/oauth/authorize
    Token URL: https://{account_name}.talkdeskid.com/oauth/token scopes: contacts:read

Path parameters

contact_idstring required

The contact id

Response

Get a contact response

Example response

{
  "id": "f68519eb9e5047b59dbf1c0e",
  "name": "Daniel Craig",
  "company": "Talkdesk",
  "phones": [
    {
      "label": "Mobile",
      "number": "+351987654321"
    },
    {
      "label": "Business",
      "number": "+321212345678"
    }
  ],
  "_links": {
    "self": {
      "href": "https://api.talkdeskapp.com/contacts/f68519eb9e5047b59dbf1c0e"
    },
    "integrations": {
      "href": "https://api.talkdeskapp.com/contacts/f68519eb9e5047b59dbf1c0e/integrations"
    }
  }
}

Changes