---
title: "Update contact persons"
method: PUT
path: "/contact/{id}/contact-persons"
tags: ["Contact"]
---

# Update contact persons

`PUT /contact/{id}/contact-persons`

## Request

- Base URL: `https://api.paidnice.com/rest/v1`
- URL: `https://api.paidnice.com/rest/v1/contact/{id}/contact-persons`
- Auth: HTTP bearer

Replaces the set of persons on a contact. Send the full desired list of persons; the change is pushed to the accounting system and the contact is then re-synced. Exactly one person must be marked as primary. The primary person is imported, while additional persons may be local depending on accounting-system rules.

## Path parameters

- `id` integer, nullable

## Request body

- UpdateContactPersonsRequest
  - `persons` ContactPersonInput[], required
    - `id` string
    - `isPrimary` boolean, required
    - `firstName` string
    - `lastName` string
    - `email` string
    - `mobileNumber` string
    - `mobileCountryCode` string
    - `defaultNumber` string
    - `defaultCountryCode` string
    - `includeInNotifications` boolean
    - `sourceType` 'imported' | 'local'

## Response `200`

The updated contact

- Contact
  - `id` integer, required
  - `name` string, required
  - `accountingSystemId` string, required
  - `status` 'ACTIVE' | 'ARCHIVED', required
  - `accountNumber` string
  - `smsOptedOut` boolean, required
  - `contactPersons` object[], required
    - `id` string, uuid, required
    - `isPrimary` boolean, required
    - `firstName` string
    - `lastName` string
    - `email` string
    - `mobileNumber` string
    - `mobileNumberCountryCode` string
    - `defaultNumber` string
    - `defaultNumberCountryCode` string
    - `includeInNotifications` boolean, required
    - `sourceType` 'imported' | 'local', required
  - `groupId` integer, required
  - `groupTitle` string, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: The public API is not enabled for the organisation, or the API key lacks the required scope
- `404`: The contact could not be found
- `429`: Too many requests

---

[API](https://skmtc.dev/paidnice/apis/paidnice-public-api.md) · [All operations](https://skmtc.dev/paidnice/apis/paidnice-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paidnice/apis/paidnice-public-api/revisions/d4911087b8e7?raw)