---
title: "Changes to Create or update a contact"
method: POST
path: "/api/contacts.upsert"
---

# Changes to Create or update a contact

`POST /api/contacts.upsert`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 25 revisions.

- **2025-12-02** `c9edbbd76e08` — 4 warning
- **2025-12-01** `bca4a43d9d46` — 1 warning, 3 info
- **2025-11-30** `f018ea668217` — 4 warning, 4 info
- **2025-11-29** `c39acad12e49` — 6 warning
- **2025-11-01** `6d2b86adbdc3` — 2 info
- **2025-08-24** `384ae1bf1437` — 1 info

## Changes

- **2025-12-02** `c9edbbd76e08` — 4 warning
  - removed the request property `contact/contact_lists`
  - removed the request property `contact/contact_segments`
  - removed the request property `contact/created_at`
  - removed the request property `contact/updated_at`
- **2025-12-01** `bca4a43d9d46` — 1 warning, 3 info
  - added the new `error` enum value to the `action` response property for the response status `200`
  - added the new optional request property `contact/contact_segments`
  - added the new optional request property `contact/full_name`
  - added the optional property `error` to the response with the `200` status
- **2025-11-30** `f018ea668217` — 4 warning, 4 info
  - removed the optional property `contact` from the response with the `200` status
  - removed the optional property `error` from the response with the `200` status
  - added the new `create` enum value to the `action` response property for the response status `200`
  - added the new `update` enum value to the `action` response property for the response status `200`
  - added the optional property `email` to the response with the `200` status
  - removed the `created` enum value from the `action` response property for the response status `200`
  - removed the `unchanged` enum value from the `action` response property for the response status `200`
  - removed the `updated` enum value from the `action` response property for the response status `200`
- **2025-11-29** `c39acad12e49` — 6 warning
  - removed the request property `contact/last_order_at`
  - removed the request property `contact/lifetime_value`
  - removed the request property `contact/orders_count`
  - removed the optional property `contact/last_order_at` from the response with the `200` status
  - removed the optional property `contact/lifetime_value` from the response with the `200` status
  - removed the optional property `contact/orders_count` from the response with the `200` status
- **2025-11-01** `6d2b86adbdc3` — 2 info
  - added the new optional request property `contact/contact_lists`
  - added the optional property `contact/contact_lists` to the response with the `200` status
- **2025-08-24** `384ae1bf1437` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pierre-b/apis/notifuse-api/docs/api/contacts.upsert/post.md) · [API](https://skmtc.dev/pierre-b/apis/notifuse-api.md) · [Page](https://skmtc.dev/pierre-b/apis/notifuse-api/changes/api/contacts.upsert/post)