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

# Contact event

`POST contact` (webhook)

Webhook sent on each call (incoming and outgoing), it will allow you to transmit notes to the agent. The notes are located next to the contact's photo, in the information bubble of the call window. You can set custom information in the data object (refer to the object below).

To certify that the request was sent by Ringover, the `x-ringover-webhook-signature` header must be a JWT signed with the webhook key you can find in the Contact Call section of the webhook configuration page of Ringover dashboard, using algorithm HS512.

## Payload

- WebhookRequestContact
  - `event` string
  - `resource` string
  - `timestamp` number
  - `data` object
    - `call_id` integer
    - `direction` 'inbound' | 'outbound'
    - `from_number` string
    - `to_number` string

## Acknowledgement `200`

Successful operation

- WebhookResponseContact
  - `uuid` string, uuid
  - `firstname` string
  - `lastname` string
  - `company` string
  - `url` string
  - `data` object — Object for your personalized data.
    - `key1` string
    - `key2` string
    - `keyN` string
  - `is_shared` boolean

## 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)