From 81e72a17dec57267c270128a006fa8da1e657c0f Mon Sep 17 00:00:00 2001 From: Varshini Suresh Date: Mon, 8 Jun 2026 12:26:03 +0100 Subject: [PATCH] docs(contacts): document 409 Conflict on Create contact Add the 409 Conflict response to POST /contacts across all description versions (2.7-2.15 + 0/Preview), with two named examples: a live-duplicate and an archived-duplicate. Co-Authored-By: Claude Opus 4.8 (1M context) --- descriptions/0/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.10/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.11/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.12/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.13/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.14/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.15/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.7/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.8/api.intercom.io.yaml | 21 +++++++++++++++++++++ descriptions/2.9/api.intercom.io.yaml | 21 +++++++++++++++++++++ 10 files changed, 210 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index a33f1c6..25ffe46 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -6812,6 +6812,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 2c6eaed..c54aa9e 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -3969,6 +3969,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 0ffd407..7766d79 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -4068,6 +4068,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 2927825..67d1302 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -4590,6 +4590,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index e86c00d..05fd9a8 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -5111,6 +5111,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 35a8a65..73fc09f 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -5921,6 +5921,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 92f319d..611a9bf 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -5992,6 +5992,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index 55c3393..c638314 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -4187,6 +4187,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index 4e773cc..dfe9a39 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -4187,6 +4187,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index 852f7fc..6da5ef9 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -4187,6 +4187,27 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '409': + description: Conflict - a contact matching those details already exists + content: + application/json: + examples: + Contact already exists: + value: + type: error.list + request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13 + errors: + - code: conflict + message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + Archived contact already exists: + value: + type: error.list + request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24 + errors: + - code: conflict + message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83 + schema: + "$ref": "#/components/schemas/error" requestBody: content: application/json: