---
title: "Directory listing synced (success/incomplete)"
method: POST
path: "listing.submission"
tags: ["Webhooks/Webhooks", "Webhooks"]
---

# Directory listing synced (success/incomplete)

`POST listing.submission` (webhook)

**Event name:** `listing.submission`

Sent when Synup finishes attempting to sync a business listing to a directory (Google, Facebook, etc.), triggered by profile updates or new directory submissions. Delivered to your Webhooks URL (Listings webhook). One delivery per status change — a move from incomplete to success sends two separate calls. Note the compact envelope: there is no top-level timestamp or account_id, and the location is identified by the Base64 id inside data.

## Headers

- `X-Synup-Signature` string, required

## Payload

- object
  - `event` string: Always "listing.submission".
  - `status` string: "success" (listing is live on the directory) or "incomplete" (could not be completed).
  - `live_link` string: Public URL of the live listing. Present only when status is "success".
  - `error_message` string: Why the submission could not be completed. Present only when status is "incomplete".
  - `data` object
    - `business_id` integer: Synup's internal numeric ID for the location.
    - `v4_business_id` string: Base64-encoded location identifier for the v4 API. Same value as data.location_id.
    - `location_id` string: Base64-encoded location identifier. Same value as data.v4_business_id.
    - `site` object: The directory the listing was synced to.
      - `id` integer: Synup's internal ID for the directory.
      - `name` string: Directory name (e.g. "Google", "Yelp", "Infobel").
      - `url` string: Root domain of the directory (e.g. "infobel.com").

## Acknowledgement `200`

Acknowledge with any 2xx. A non-2xx (or timeout) is recorded as a failed delivery; failures are logged but not automatically retried at this time.

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