---
title: "Contact Search event"
method: POST
path: "contact_search"
tags: ["webhook"]
---

# Contact Search event

`POST contact_search` (webhook)

The webhook is triggered during a search on myringover (in the smartdialer, on contacts tabs, ...). In order to get from your API the contact's informations and numbers.

To certify that the request was sent by Ringover, the `Authorization` header must be equal to the webhook key you can find in the webhook configuration page of Ringover dashboard.

## Payload

- WebhookRequestContactsearch
  - `event` string
  - `ressource` string
  - `timestamp` number
  - `data` object
    - `query_search` string
    - `user_id` integer

## Acknowledgement `200`

Successful operation

- WebhookResponseContactsearchObject[]
  - `firstname` string
  - `lastname` string
  - `company` string
  - `url` string
  - `numbers` SearchNumberContact[]
    - `number` integer — Phone number (E.164 format)
    - `type` 'home' | 'office' | 'mobile' | 'fax' | 'other'

## Other responses

- `default` — Other response code are ignored

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)