finov.ioDocumentationHome

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"
  }
}