/v1/comms/connections/{id}/contacts/importImport a connected account's contacts
Reads the saved address book of one of the caller's OWN connected Google (Contacts, not 'Other contacts') or Microsoft accounts and lands it on the Contacts board: one contact per address, owned by the caller, Source connected_account; an existing contact only gains a name it lacked and is never overwritten. Runs now and answers the run (the same shape as get_comms_connections_id_contacts); a daily sweep repeats it. needs_consent and failed are answered as the run's state, not errors. Imported contacts do not count as known for the Inbox's board-only list.
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.
Request body
application/jsonrequiredResponses
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"
}