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

# bulk_sync.failed

Fires when a Bulk Sync execution fails because every object failed, an error stopped the whole execution, or ingestion fell behind the failure threshold set on the Bulk Sync. An execution ends with one of `bulk_sync.completed`, `bulk_sync.completed_with_errors`, `bulk_sync.failed`, or `bulk_sync.canceled`.

## Payload fields

| Field | Type | Always present | Description |
| --- | --- | --- | --- |
| `sync_name` | string | Yes | Name of the Bulk Sync |
| `organization_id` | string (UUID) | Yes | Organization ID |
| `sync_id` | string (UUID) | Yes | Bulk Sync ID |
| `execution_id` | string (UUID) | Yes | Execution ID |
| `source_connection_id` | string (UUID) | Yes | Source connection ID |
| `destination_connection_id` | string (UUID) | Yes | Destination connection ID |
| `error` | string | Yes | Error message for the failed execution |
| `trigger_source` | string | Yes | What started the execution |
| `schedule` | object | No | Schedule that started the execution |
| `schedule.id` | string (UUID) | No | Bulk Sync schedule ID |
| `schedule.frequency` | string | No | Frequency of the schedule |

## 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": "4e59aafc-c317-5806-819a-5e41c4f851ad",
  "created_at": "2024-01-01T02:00:00Z",
  "type": "bulk_sync.failed",
  "event": {
    "sync_name": "Asana to BigQuery",
    "organization_id": "be80a27e-0e80-4dcb-bee9-1666f02eeb83",
    "sync_id": "dcc891b3-4a25-4b8b-bba8-48104cd66525",
    "execution_id": "8114c8cc-99fc-4fb4-ab72-28308762fa63",
    "source_connection_id": "ad56197c-1bca-4256-a410-fb1ffde295c0",
    "destination_connection_id": "318dba62-d875-11ed-b59b-ea7534cffcab",
    "error": "source connection authentication failed",
    "trigger_source": "scheduled",
    "schedule": {
      "id": "5f4a9c1e-3b7d-4e2a-8c6f-1d9e0a7b2c34",
      "frequency": "hourly"
    }
  }
}
```