---
title: "Changes to Upsert (update or create) a single lead."
method: POST
path: "/api/external/v1/leads/upsert-lead"
---

# Changes to Upsert (update or create) a single lead.

`POST /api/external/v1/leads/upsert-lead`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-08-18** `29a37db12acb` — 1 info
- **2026-08-17** `dd3f47f72f7a` — 1 warning, 7 info

## Changes

- **2026-08-18** `29a37db12acb` — 1 info
  - the request property `from` became optional
- **2026-08-17** `dd3f47f72f7a` — 1 warning, 7 info
  - removed the optional property `genpage_url` from the response with the `200` status
  - added the new optional request property `audience_id`
  - added the new optional request property `enrich_data`
  - added the new optional request property `generate_ai_variables`
  - added the new optional request property `send_email`
  - added the non-success response with the status `404`
  - removed the non-success response with the status `503`
  - added the optional property `job_id` to the response with the `200` status

---

[Operation](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/docs/api/external/v1/leads/upsert-lead/post.md) · [API](https://skmtc.dev/genpage/apis/genpage-external-api-documentation.md) · [Page](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/changes/api/external/v1/leads/upsert-lead/post)
