RinghouseAPI reference
Get started

Contacts

List contacts

List the contacts shared with the whole team; private ones belong to a person, and a key is not one.

GET/v1/contacts

Needs the contacts:read scope.

Query parameters

limitinteger
1–100, default 25.
cursorstring
The `nextCursor` from a previous response.
idsstring
Fetch specific items by id, comma separated, up to 100. Overrides paging when given.

Returns

A page of contacts. The items are in data, and nextCursor fetches the next page. A failed call answers with an error instead.

idstring
companystringnullable
createdAtstring
emailstringnullable
firstNamestring
jobTitlestringnullable
lastNamestring
notesstringnullable
phoneNumberstring
updatedAtstring
websitestringnullable
curl https://api.ringhouse.ai/v1/contacts \
  -H "Authorization: Bearer rh_live_xxxxxxxx"
{
  "data": [
    {
      "id": "4b1a8d2e-6c3f-47b9-8e05-d91a2c7f6b34",
      "company": "Northwind",
      "createdAt": "2026-09-25T14:02:11Z",
      "email": "ada@example.com",
      "firstName": "Ada",
      "jobTitle": "Office manager",
      "lastName": "Lovelace",
      "notes": "Prefers a text to a call",
      "phoneNumber": "+441134960000",
      "updatedAt": "2026-09-25T14:02:11Z",
      "website": "https://northwind.example.com"
    }
  ],
  "nextCursor": "MjAyNi0wOS0yNVQxNDowMjoxMVp8M2Y5YzFhMmU"
}
Was this page helpful?
Previous← Set conversation statusNextGet a contact