Get Contact

GET

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

GET

/contacts/:uuid

const url = 'https://api.calendly.com/contacts/AAAAAAAAAAAAAAAA?exclude=custom_fields';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "resource": {
    "uri": "https://api.calendly.com/contacts/CCCCCCCCCCCCCCCC",
    "emails": [
      {
        "email": "test@example.com",
        "is_primary": true
      }
    ],
    "created_at": "2026-01-15T18:01:09Z",
    "updated_at": "2026-01-15T18:01:09Z",
    "name": "Jane Doe",
    "phone_numbers": [
      {
        "phone_number": "+1 888-888-8888"
      }
    ],
    "timezone": "America/Los_Angeles",
    "job_title": "Director of Operations",
    "company": "ExampleCo",
    "country": "US",
    "state": "CA",
    "city": "San Francisco",
    "linkedin": "https://www.linkedin.com/in/janedoe",
    "custom_fields": [
      {
        "uri": "https://api.calendly.com/contacts/custom_field_definitions/CCCCCCCCCCCCCCCC",
        "value": "event",
        "label": "Lead source"
      }
    ],
    "first_email_date": "2026-01-08T11:00:00.000Z",
    "last_email_date": "2026-01-08T11:00:00.000Z",
    "next_meeting_date": "2026-01-08T11:00:00.000Z",
    "last_meeting_date": "2026-01-08T11:00:00.000Z",
    "last_interaction_date": "2026-01-08T11:00:00.000Z"
  }
}

Returns the details of a specified Contact.

Required scopes

contacts:read

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