> This page is for version 2023-04-25.
> For other versions, use one of these documentation indexes:
> - 2025-09-18 (default): https://apidocs.polytomic.com/2025-09-18/llms.txt
> - 2024-02-08: https://apidocs.polytomic.com/2024-02-08/llms.txt
> - 2023-04-25: https://apidocs.polytomic.com/2023-04-25/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# sync.failed

Fires when a Model Sync execution fails. The execution also fires `sync.completed` with a `status` of `failed`.

## Payload fields

| Field | Type | Always present | Description |
| --- | --- | --- | --- |
| `organization_id` | string (UUID) | Yes | Organization ID |
| `sync_name` | string | Yes | Name of the Model Sync |
| `sync_id` | string (UUID) | Yes | Model Sync ID |
| `execution_id` | string (UUID) | Yes | Execution ID |
| `target_connection_id` | string (UUID) | Yes | Destination connection ID |
| `error` | string | Yes | Error message for the failed execution |

## Example

This example shows a webhook delivery, with the fields above in `event`. See the
[events overview](/2023-04-25/events/overview) for the delivery format.

```json
{
  "id": "e9553aee-833f-5685-a9b5-e3e50ee571f8",
  "created_at": "2024-01-01T02:00:00Z",
  "type": "sync.failed",
  "event": {
    "organization_id": "be80a27e-0e80-4dcb-bee9-1666f02eeb83",
    "sync_name": "Salesforce contacts",
    "sync_id": "0b155265-c537-44c9-9359-a3ceb468a4da",
    "execution_id": "0ecd09c1-b901-4d27-9053-f0367c427254",
    "target_connection_id": "7c67e0b3-9759-44eb-b96c-2a7042b583f0",
    "error": "destination connection authentication failed"
  }
}
```