Get Contact

GET

https://api.calendly.com/contacts/:uuid

GET

/contacts/:uuid

1 const url = 'https://api.calendly.com/contacts/AAAAAAAAAAAAAAAA';
2 const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
3 
4 try {
5   const response = await fetch(url, options);
6   const data = await response.json();
7   console.log(data);
8 } catch (error) {
9   console.error(error);
10 }

1 {
2   "resource": {
3     "uri": "https://api.calendly.com/contacts/CCCCCCCCCCCCCCCC",
4     "emails": [
5       {
6         "email": "test@example.com",
7         "is_primary": true
8       }
9     ],
10     "created_at": "2026-01-15T18:01:09Z",
11     "updated_at": "2026-01-15T18:01:09Z",
12     "name": "Jane Doe",
13     "phone_numbers": [
14       {
15         "phone_number": "+1 888-888-8888"
16       }
17     ],
18     "timezone": "America/Los_Angeles",
19     "job_title": "Director of Operations",
20     "company": "ExampleCo",
21     "country": "US",
22     "state": "CA",
23     "city": "San Francisco",
24     "linkedin": "https://www.linkedin.com/in/janedoe",
25     "custom_fields": [
26       {
27         "uri": "https://api.calendly.com/contacts/custom_field_definitions/CCCCCCCCCCCCCCCC",
28         "value": "event",
29         "label": "Lead source"
30       }
31     ],
32     "first_email_date": "2026-01-08T11:00:00.000Z",
33     "last_email_date": "2026-01-08T11:00:00.000Z",
34     "next_meeting_date": "2026-01-08T11:00:00.000Z",
35     "last_meeting_date": "2026-01-08T11:00:00.000Z",
36     "last_interaction_date": "2026-01-08T11:00:00.000Z"
37   }
38 }

Returns the details of a specified Contact.

Required scopes

contacts:read

Returns the details of a specified Contact. <Info title="Required scopes"> > `contacts:read` </Info>

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Path parameters

uuidstringRequired

Query parameters

excludestringOptional

Omit the listed fields from the response. Currently only custom_fields is supported. When omitted, all fields are returned.

Response

resourceobject

Information about a contact.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error