Restore a contact
API Documentation / Resources / Contacts
Restore an archived contact
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/contacts/{contact_id}/restore
Required OAuth scope: contacts:write
Restores an archived contact and its archived addresses.
This operation is retry-safe: restoring an already active contact returns
the current representation with 200 OK and does not create duplicates.
A subsidiary inheriting its contact directory must restore the contact at
the source subsidiary.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the bank account. |
contact_id |
path | Yes | string (uuid) | UUID of a customer or supplier contact. |
Request
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/contacts/{contact_id}/restore HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Length: 0
Responses
| Status | Description |
|---|---|
200 |
Restored or already-active contact. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
404 |
Resource does not exist in the granted accounting context. |
409 |
Request conflicts with inheritance, open invoices, or uniqueness. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": "a68d68ec-5866-42e5-8864-57829d3f91b5",
"name": "Koru Office Limited",
"type": "customer",
"tax_identity": "NZ123456789",
"invoice_email": "[email protected]",
"currency_code": "NZD",
"payment_term_id": null,
"addresses": [],
"contact_people": [],
"active": true,
"created_at": "2026-08-10T12:30:00Z",
"updated_at": "2026-08-10T13:00:00Z",
"restored_at": "2026-08-10T13:00:00Z"
}
}