CRM sync issues
Records the CRM sync could not write: list, retry or dismiss them.
List sync issues (Needs attention)
GET
/v1/crm-connections/{connectionId}/sync-issuescrm-sync-issues.listNeeds the ingestion feature on your workspace. Until it is on, calls answer 404.
Writes the CRM refused, newest first. limit 1-200 (default 50), cursor from pagination.nextCursor.
Parameters
Name
In
Type
Required
Description
connectionId
In: path
integer (int64)
required
limit
In: query
integer (int32)
optional
cursor
In: query
string
optional
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 200
data is a list of CrmSyncIssueModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
id
integer (int64)
kind
string
entityRef
string
error
string
attempts
integer (int32)
createdAt
string (date-time)
updatedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/crm-connections/812/sync-issues?limit=1" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"success": true,
"data": [
{
"id": 812,
"kind": "string",
"entityRef": "string",
"error": "string",
"attempts": 1,
"createdAt": "2026-09-23T15:02:11Z",
"updatedAt": "2026-09-23T15:02:11Z"
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}Retry a sync issue
POST
/v1/crm-connections/{connectionId}/sync-issues/{issueId}/retrycrm-sync-issues.retryNeeds the ingestion feature on your workspace. Until it is on, calls answer 404.
Sends the write to the CRM again on the next drain. Requires the integrations permission.
Parameters
Name
In
Type
Required
Description
connectionId
In: path
integer (int64)
required
issueId
In: path
integer (int64)
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 204
Request
curl -X POST "https://api.ken.so/v1/crm-connections/812/sync-issues/812/retry" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 204
HTTP/1.1 204 No Content
Dismiss a sync issue
DELETE
/v1/crm-connections/{connectionId}/sync-issues/{issueId}crm-sync-issues.dismissNeeds the ingestion feature on your workspace. Until it is on, calls answer 404.
Ken stops retrying the write. Requires the integrations permission.
Parameters
Name
In
Type
Required
Description
connectionId
In: path
integer (int64)
required
issueId
In: path
integer (int64)
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 204
Request
curl -X DELETE "https://api.ken.so/v1/crm-connections/812/sync-issues/812" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 204
HTTP/1.1 204 No Content