---
title: "Share-of-Voice snapshot completed"
method: POST
path: "rankings.sov_snapshot_completed"
tags: ["Webhooks/Webhooks", "Webhooks"]
---

# Share-of-Voice snapshot completed

`POST rankings.sov_snapshot_completed` (webhook)

**Event name:** `rankings.sov_snapshot_completed`

A Share-of-Voice snapshot was stored for a keyword (one event per keyword). Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

## Headers

- `X-Synup-Signature` string, required

## Payload

- object
  - `event` string: Dotted event name.
  - `timestamp` string: ISO-8601 UTC time the event was emitted.
  - `account_id` integer: Synup account the event belongs to.
  - `location_id` string: Numeric string for location-scoped events; null for brand-scoped events.
  - `data` object
    - `keyword_id` string: SoV keyword identifier.
    - `engine` string: Search engine (defaults to "google").
    - `snapshot_date` string: Capture date, YYYY-MM-DD.
    - `sov` number: Share-of-voice value.
    - `rank` integer: Computed rank position.

## Acknowledgement `200`

Your endpoint acknowledges receipt with any 2xx. A non-2xx response or a timeout (>10s) is treated as a failed delivery.

- object

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)