Contacts

The Contacts API lets you manage your trusted contacts. Trusted contacts can see your availability and schedule meetings with you directly.

List Contacts

GET/v1/contacts

Returns a list of your trusted contacts.

Query Parameters

ParameterTypeDescription
includeBlockedbooleanWhether to include blocked contacts in the response. Defaults to false.

Example Request

curl https://api.meetsynced.com/v1/contacts \
  -H "Authorization: Bearer sk_live_your_api_key"

Example Response

{
  "data": [
    {
      "id": "ctc_abc123",
      "email": "alice@acme.com",
      "name": "Alice Chen",
      "relationship": "colleague",
      "blocked": false,
      "addedAt": "2025-03-01T12:00:00Z"
    },
    {
      "id": "ctc_def456",
      "email": "bob@partner.io",
      "name": "Bob Rivera",
      "relationship": "client",
      "blocked": false,
      "addedAt": "2025-04-15T08:30:00Z"
    }
  ]
}

Create Contact

POST/v1/contacts

Adds a new trusted contact. The contact will be able to view your availability.

Body Parameters

ParameterTypeDescription
emailrequiredstringEmail address of the contact to add.
relationshipstringRelationship label for the contact. One of "colleague", "client", "friend", or "other". Defaults to "other".

Example Request

curl -X POST https://api.meetsynced.com/v1/contacts \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "sarah@startup.com",
    "relationship": "client"
  }'

Example Response

{
  "id": "ctc_ghi789",
  "email": "sarah@startup.com",
  "name": null,
  "relationship": "client",
  "blocked": false,
  "addedAt": "2025-06-20T16:45:00Z"
}

Contact names

The name field is populated automatically when the contact has a Synced account. For contacts without an account, the name will be null until they sign up.