---
title: "Update contact"
method: PATCH
path: "/contacts/{id}"
tags: ["Contacts"]
---

# Update contact

`PATCH /contacts/{id}`

## Request

- Base URL: `https://api.echtpost.de/v2`
- URL: `https://api.echtpost.de/v2/contacts/{id}`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://my.echtpost.de/oauth/authorize`, token URL `https://my.echtpost.de/oauth/token`, scopes: `mcp`)
  - API key in header `X-Api-Key`
  - HTTP bearer

## Request body

- RecipientInput
  - `first_name` string
  - `last_name` string, required
  - `title` string
  - `greeting_style` 'formal' | 'informal' | 'custom'
  - `custom_salutation` string
  - `gender` string
  - `company_name` string
  - `department` string
  - `street` string, required
  - `zip` string, required
  - `city` string, required
  - `state_code` string
  - `country_code` string, required
  - `birthdate` string, date
  - `external_id` string

## Response `200`

OK

- Contact
  - `id` integer
  - `account_id` integer
  - `first_name` string
  - `last_name` string
  - `title` string
  - `greeting_style` 'formal' | 'informal' | 'custom'
  - `custom_salutation` string, nullable
  - `greeting` string, nullable
  - `gender` string, nullable
  - `company_name` string, nullable
  - `department` string, nullable
  - `street` string
  - `zip` string
  - `city` string
  - `state_code` string, nullable
  - `country_code` string: ISO 3166-1 alpha-2
  - `birthdate` string, date, nullable
  - `external_id` string, nullable
  - `group_ids` integer[]: Only present with `include=groups`
  - `card_ids` string[]: Only present with `include=cards`
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Authentication required
- `404`: Resource not found
- `422`: Unprocessable Entity

---

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