Skip to content

Commit 81e72a1

Browse files
VarshSureshclaude
VarshSuresh
and
claude
committed
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) <noreply@anthropic.com>
1 parent ef81c41 commit 81e72a1

10 files changed

Lines changed: 210 additions & 0 deletions

‎descriptions/0/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6812,6 +6812,27 @@ paths:
68126812
message: Access Token Invalid
68136813
schema:
68146814
"$ref": "#/components/schemas/error"
6815+
'409':
6816+
description: Conflict - a contact matching those details already exists
6817+
content:
6818+
application/json:
6819+
examples:
6820+
Contact already exists:
6821+
value:
6822+
type: error.list
6823+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
6824+
errors:
6825+
- code: conflict
6826+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
6827+
Archived contact already exists:
6828+
value:
6829+
type: error.list
6830+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
6831+
errors:
6832+
- code: conflict
6833+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
6834+
schema:
6835+
"$ref": "#/components/schemas/error"
68156836
requestBody:
68166837
content:
68176838
application/json:

‎descriptions/2.10/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3969,6 +3969,27 @@ paths:
39693969
message: Access Token Invalid
39703970
schema:
39713971
"$ref": "#/components/schemas/error"
3972+
'409':
3973+
description: Conflict - a contact matching those details already exists
3974+
content:
3975+
application/json:
3976+
examples:
3977+
Contact already exists:
3978+
value:
3979+
type: error.list
3980+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
3981+
errors:
3982+
- code: conflict
3983+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
3984+
Archived contact already exists:
3985+
value:
3986+
type: error.list
3987+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
3988+
errors:
3989+
- code: conflict
3990+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
3991+
schema:
3992+
"$ref": "#/components/schemas/error"
39723993
requestBody:
39733994
content:
39743995
application/json:

‎descriptions/2.11/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4068,6 +4068,27 @@ paths:
40684068
message: Access Token Invalid
40694069
schema:
40704070
"$ref": "#/components/schemas/error"
4071+
'409':
4072+
description: Conflict - a contact matching those details already exists
4073+
content:
4074+
application/json:
4075+
examples:
4076+
Contact already exists:
4077+
value:
4078+
type: error.list
4079+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
4080+
errors:
4081+
- code: conflict
4082+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4083+
Archived contact already exists:
4084+
value:
4085+
type: error.list
4086+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
4087+
errors:
4088+
- code: conflict
4089+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4090+
schema:
4091+
"$ref": "#/components/schemas/error"
40714092
requestBody:
40724093
content:
40734094
application/json:

‎descriptions/2.12/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4590,6 +4590,27 @@ paths:
45904590
message: Access Token Invalid
45914591
schema:
45924592
"$ref": "#/components/schemas/error"
4593+
'409':
4594+
description: Conflict - a contact matching those details already exists
4595+
content:
4596+
application/json:
4597+
examples:
4598+
Contact already exists:
4599+
value:
4600+
type: error.list
4601+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
4602+
errors:
4603+
- code: conflict
4604+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4605+
Archived contact already exists:
4606+
value:
4607+
type: error.list
4608+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
4609+
errors:
4610+
- code: conflict
4611+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4612+
schema:
4613+
"$ref": "#/components/schemas/error"
45934614
requestBody:
45944615
content:
45954616
application/json:

‎descriptions/2.13/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5111,6 +5111,27 @@ paths:
51115111
message: Access Token Invalid
51125112
schema:
51135113
"$ref": "#/components/schemas/error"
5114+
'409':
5115+
description: Conflict - a contact matching those details already exists
5116+
content:
5117+
application/json:
5118+
examples:
5119+
Contact already exists:
5120+
value:
5121+
type: error.list
5122+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
5123+
errors:
5124+
- code: conflict
5125+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
5126+
Archived contact already exists:
5127+
value:
5128+
type: error.list
5129+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
5130+
errors:
5131+
- code: conflict
5132+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
5133+
schema:
5134+
"$ref": "#/components/schemas/error"
51145135
requestBody:
51155136
content:
51165137
application/json:

‎descriptions/2.14/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5921,6 +5921,27 @@ paths:
59215921
message: Access Token Invalid
59225922
schema:
59235923
"$ref": "#/components/schemas/error"
5924+
'409':
5925+
description: Conflict - a contact matching those details already exists
5926+
content:
5927+
application/json:
5928+
examples:
5929+
Contact already exists:
5930+
value:
5931+
type: error.list
5932+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
5933+
errors:
5934+
- code: conflict
5935+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
5936+
Archived contact already exists:
5937+
value:
5938+
type: error.list
5939+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
5940+
errors:
5941+
- code: conflict
5942+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
5943+
schema:
5944+
"$ref": "#/components/schemas/error"
59245945
requestBody:
59255946
content:
59265947
application/json:

‎descriptions/2.15/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5992,6 +5992,27 @@ paths:
59925992
message: Access Token Invalid
59935993
schema:
59945994
"$ref": "#/components/schemas/error"
5995+
'409':
5996+
description: Conflict - a contact matching those details already exists
5997+
content:
5998+
application/json:
5999+
examples:
6000+
Contact already exists:
6001+
value:
6002+
type: error.list
6003+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
6004+
errors:
6005+
- code: conflict
6006+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
6007+
Archived contact already exists:
6008+
value:
6009+
type: error.list
6010+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
6011+
errors:
6012+
- code: conflict
6013+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
6014+
schema:
6015+
"$ref": "#/components/schemas/error"
59956016
requestBody:
59966017
content:
59976018
application/json:

‎descriptions/2.7/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4187,6 +4187,27 @@ paths:
41874187
message: Access Token Invalid
41884188
schema:
41894189
"$ref": "#/components/schemas/error"
4190+
'409':
4191+
description: Conflict - a contact matching those details already exists
4192+
content:
4193+
application/json:
4194+
examples:
4195+
Contact already exists:
4196+
value:
4197+
type: error.list
4198+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
4199+
errors:
4200+
- code: conflict
4201+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4202+
Archived contact already exists:
4203+
value:
4204+
type: error.list
4205+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
4206+
errors:
4207+
- code: conflict
4208+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4209+
schema:
4210+
"$ref": "#/components/schemas/error"
41904211
requestBody:
41914212
content:
41924213
application/json:

‎descriptions/2.8/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4187,6 +4187,27 @@ paths:
41874187
message: Access Token Invalid
41884188
schema:
41894189
"$ref": "#/components/schemas/error"
4190+
'409':
4191+
description: Conflict - a contact matching those details already exists
4192+
content:
4193+
application/json:
4194+
examples:
4195+
Contact already exists:
4196+
value:
4197+
type: error.list
4198+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
4199+
errors:
4200+
- code: conflict
4201+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4202+
Archived contact already exists:
4203+
value:
4204+
type: error.list
4205+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
4206+
errors:
4207+
- code: conflict
4208+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4209+
schema:
4210+
"$ref": "#/components/schemas/error"
41904211
requestBody:
41914212
content:
41924213
application/json:

‎descriptions/2.9/api.intercom.io.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4187,6 +4187,27 @@ paths:
41874187
message: Access Token Invalid
41884188
schema:
41894189
"$ref": "#/components/schemas/error"
4190+
'409':
4191+
description: Conflict - a contact matching those details already exists
4192+
content:
4193+
application/json:
4194+
examples:
4195+
Contact already exists:
4196+
value:
4197+
type: error.list
4198+
request_id: 1f8a3c5d-9b2e-4d7a-8c61-2e4f6a8b0d13
4199+
errors:
4200+
- code: conflict
4201+
message: A contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4202+
Archived contact already exists:
4203+
value:
4204+
type: error.list
4205+
request_id: 2a9b4d6e-0c3f-4e8b-9d72-3f5a7b9c1e24
4206+
errors:
4207+
- code: conflict
4208+
message: An archived contact matching those details already exists with id=6762f0dd1bb69f9f2193bb83
4209+
schema:
4210+
"$ref": "#/components/schemas/error"
41904211
requestBody:
41914212
content:
41924213
application/json:

0 commit comments

Comments
 (0)