# Import 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`.

## Endpoint

`POST /v1/comms/connections/{id}/contacts/import`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| id | path | string | Yes |

## Request body

Content type: `application/json`.

```json
{}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "connectionId": "",
    "created": 1,
    "error": "string",
    "lastRunAt": "2026-01-01T00:00:00Z",
    "seen": 1,
    "status": "string",
    "truncated": true,
    "updated": 1
  }
}
```

### default

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.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
