Find Contact

POST …/contacts/find

Synchronously search for contacts within your organization. Returns a list of matching contacts with their contact details and contributors.

This endpoint is synchronous — results are returned inline in the response.

Request

POST {WEBHOOK_BASE_URL}/{token}/contacts/find
Content-Type: application/json

{
  "full_name": "John Doe",
  "phone_number": "5550000001",
  "contact_email": "john.doe@example.com",
  "match_any": false
}

Body fields

Matching logic

By default, Goliath uses strict matching — all provided fields must match the same contact.

If match_any: true is set and strict matching returns no results, Goliath falls back to searching each field individually:

1. Name only
2. Phone only
3. Email only

Results from the first successful fallback are returned.

Response

200 OK

[
  {
    "id": "a1b2c3d4-0000-0000-0000-000000000000",
    "name": "John Doe",
    "phones": ["5550000001"],
    "emails": ["john.doe@example.com"],
    "addresses": ["123 Main St, Springfield, USA 00000"],
    "contributors": [
      { "id": "user-uuid", "name": "Sarah Smith" }
    ],
    "tags": [
      { "text": "Motivated Seller", "value": "motivated-seller" }
    ]
  }
]

Returns an empty array [] if no contacts match.

Error responses