/v1/comms/connections/{id}/contactsRead a connected account's contact import
How the last import of one of the caller's OWN connected Google or Microsoft accounts' saved contacts onto the Contacts board went, by the connection's id (get_connections lists them): status never, running, imported, failed (with the provider's words) or needs_consent (the account was connected before Specter asked for contacts; reconnect it), plus how many addresses were read, created and updated and when it last ran. Somebody else's connection is a not-found.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Responses
the action's answer
{
"data": {
"connectionId": "",
"created": 1,
"error": "string",
"lastRunAt": "2026-01-01T00:00:00Z",
"seen": 1,
"status": "string",
"truncated": true,
"updated": 1
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}