v1.0
post
/ec-site-svc/rest/v1.0/contacts
Creates a contact record using the provided demographic, role, and association details.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ContactModelDto
Type:
objectTitle:
ContactModelDtoPayload describing a contact with addresses, properties, and modes.
Show Source
-
contact(required): object
ContactDto
Title:
ContactDtoRepresents the contact entity details. -
contactAddressesDetails(required): object
EntityAddressAssociationDto
Title:
EntityAddressAssociationDtoRepresents an address linked to an entity. -
modes: object
ModeDto
Title:
ModeDtoRepresents a mode assignment for an entity. -
properties: object
PROPERTY_DTO_TITLE
Title:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC
Nested Schema : ContactDto
Type:
objectTitle:
ContactDtoRepresents the contact entity details.
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
contactId: string
Title:
Contact IdentifierMinimum Length:0Maximum Length:50Business identifier assigned to the contact.Example:CONTACT-123 -
contactType: string
(uuid)
-
degree: string
Title:
DegreeMinimum Length:0Maximum Length:200Academic degree associated with the contact.Example:MD -
disbarmentEnd: string
(date-time)
Title:
Disbarment EndTimestamp when the disbarment period ends.Example:2024-12-31T00:00:00Z -
disbarmentStart: string
(date-time)
Title:
Disbarment StartTimestamp when the contact was disbarred.Example:2024-01-15T00:00:00Z -
firstName(required): string
Title:
First NameMinimum Length:0Maximum Length:100Contact first name.Example:John -
id: string
(uuid)
-
lastName(required): string
Title:
Last NameMinimum Length:0Maximum Length:100Contact last name.Example:Doe -
middleName: string
Title:
Middle NameMinimum Length:0Maximum Length:100Contact middle name.Example:Michael -
prefix: string
(uuid)
-
prefixCodeValue: string
Title:
Prefix CodeMinimum Length:0Maximum Length:200Display value for the prefix code.Example:Dr. -
primarySpecialityId: string
(uuid)
-
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations. -
status: string
(uuid)
-
statusCodeValue: string
Title:
Status CodeMinimum Length:0Maximum Length:200Display value for the status.Example:Active -
suffix: string
(uuid)
-
suffixCodeValue: string
Title:
Suffix CodeMinimum Length:0Maximum Length:200Display value for the suffix code.Example:Jr. -
taxId: string
Title:
Tax IDMinimum Length:0Maximum Length:50Tax identifier associated with the contact.Example:TAX-123 -
timezone: string
Title:
TimezoneDefault timezone for the contact.Example:UTC -
versionStart: string
(date-time)
Example:
2026-01-15T10:30:00Z
Example:
{
"id":"B1B8327AFAA6412287106192AB5984EF",
"firstName":"John",
"lastName":"Doe"
}Nested Schema : EntityAddressAssociationDto
Type:
objectTitle:
EntityAddressAssociationDtoRepresents an address linked to an entity.
Show Source
-
addressCity: string
-
addressPostalcode(required): string
Title:
Postal CodeMinimum Length:0Maximum Length:20Postal code for the address.Example:80202 -
addressProperties: object
PROPERTY_DTO_TITLE
Title:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC -
addressStateOrProvOrCounty: string
(uuid)
-
addressStateOrProvOrCountyCodeValue: string
-
addressStreet1: string
-
addressStreet2: string
-
addressType: string
(uuid)
Title:
Address TypeIdentifier for the address type. -
addressTypeCodeValue: string
Title:
Address Type CodeMinimum Length:0Maximum Length:150Display value for the address type.Example:Primary -
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
country: string
(uuid)
Title:
Country IDIdentifier for the country. -
countryCodeValue: string
Title:
Country CodeMinimum Length:0Maximum Length:150Display value for the country code.Example:USA -
entityId: string
(uuid)
Title:
Entity IDIdentifier of the entity owning the address. -
entityType: string
Title:
Entity TypeMinimum Length:0Maximum Length:50Type of entity for the address.Example:Contact -
id: string
(uuid)
Title:
Address Association IDUnique identifier for the entity address association. -
mainPrimary: boolean
Title:
Main Primary FlagIndicates if this is the main primary address.Example:true -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations. -
versionStart: string
(date-time)
Example:
[
{
"id":"C36A3197FDEE433FB5547EE83DE99E4B"
}
]Nested Schema : ModeDto
Type:
objectTitle:
ModeDtoRepresents a mode assignment for an entity.
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
entityId: string
(uuid)
Title:
Entity IDIdentifier of the associated entity. -
entityType: string
Title:
Entity TypeMinimum Length:0Maximum Length:50Type of entity tied to the mode.Example:Contact -
id: string
(uuid)
Title:
Mode IDUnique identifier for the mode assignment. -
mode: string
(uuid)
Title:
ModeIdentifier of the mode. -
modeCodeValue: string
Title:
Mode Code ValueMinimum Length:0Maximum Length:50Display value for the mode.Example:Operational -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations. -
versionStart: string
(date-time)
Example:
[
"test"
]Nested Schema : PROPERTY_DTO_TITLE
Type:
objectTitle:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
entityId: string
ENTITY_ID_DESCExample:
2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
entityType: string
Title:
PROPERTY_DTO_ENTITY_TYPE_TITLEMinimum Length:0Maximum Length:50PROPERTY_DTO_ENTITY_TYPE_DESCExample:INSTITUTION -
propertyName(required): string
Title:
PROPERTY_DTO_NAME_TITLEMinimum Length:0Maximum Length:100PROPERTY_DTO_NAME_DESCExample:LabId -
propertyValue(required): string
Title:
PROPERTY_DTO_VALUE_TITLEMinimum Length:0Maximum Length:500PROPERTY_DTO_VALUE_DESCExample:2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations.
Example:
[
{
"id":"C36A3197FDEE433FB5547EE83DE99E4B"
}
]Nested Schema : PROPERTY_DTO_TITLE
Type:
objectTitle:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
entityId: string
ENTITY_ID_DESCExample:
2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
entityType: string
Title:
PROPERTY_DTO_ENTITY_TYPE_TITLEMinimum Length:0Maximum Length:50PROPERTY_DTO_ENTITY_TYPE_DESCExample:INSTITUTION -
propertyName(required): string
Title:
PROPERTY_DTO_NAME_TITLEMinimum Length:0Maximum Length:100PROPERTY_DTO_NAME_DESCExample:LabId -
propertyValue(required): string
Title:
PROPERTY_DTO_VALUE_TITLEMinimum Length:0Maximum Length:500PROPERTY_DTO_VALUE_DESCExample:2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations.
Examples
Back to Top
Response
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : Contacts
Type:
Show Source
object-
comment: string
Minimum Length:
0Maximum Length:2048Additional user comment about the latest change.Example:Association adjusted after data reconciliation. -
contactId: string
Minimum Length:
0Maximum Length:50Represents contact id for this record.Example:SITE-001 -
contactType(required): string
(uuid)
Represents contact type for this record.
-
degree: string
Minimum Length:
0Maximum Length:200Represents degree for this record.Example:Sample Value -
disbarmentEnd: string
(date-time)
Represents disbarment end for this record.Example:
2026-03-16T12:00:00Z -
disbarmentStart: string
(date-time)
Represents disbarment start for this record.Example:
2026-03-16T12:00:00Z -
firstName(required): string
Minimum Length:
0Maximum Length:100Represents first name for this record.Example:Sample Name -
id: string
(uuid)
Unique identifier for this record.
-
lastName(required): string
Minimum Length:
0Maximum Length:100Represents last name for this record.Example:Sample Name -
middleName: string
Minimum Length:
0Maximum Length:100Represents middle name for this record.Example:Sample Name -
prefix: string
(uuid)
Represents prefix for this record.
-
prefixCodeValue: string
Represents prefix code value for this record.Example:
Sample Value -
primarySpecialityId: string
(uuid)
Represents primary speciality id for this record.
-
reason: string
Minimum Length:
0Maximum Length:255Reason for the latest change made to this record.Example:Protocol update requested by study operations. -
status(required): string
(uuid)
Represents status for this record.
-
statusCodeValue: string
Display value for the status code.Example:
ACTIVE -
studyAgnostic(required): string
Represents study agnostic for this record.Example:
N -
studyId(required): string
Identifier of the related study.Example:
C36A3197FDEE433FB5547EE83DE99E4B -
suffix: string
(uuid)
Represents suffix for this record.
-
suffixCodeValue: string
Represents suffix code value for this record.Example:
Sample Value -
taxId: string
Minimum Length:
0Maximum Length:50Represents tax id for this record.Example:Sample Value -
timezone: string
Represents timezone for this record.Example:
UTC -
versionStart: string
(date-time)
Timestamp when this version became active.Example:
2026-03-16T12:00:00Z
Examples
400 Response
Returned when one or more path parameters, query parameters, or request-body values fail endpoint validation.
Root Schema : SDFResponse
Type:
objectTitle:
SDFResponseWrapper for service responses containing result or error data.
Show Source
-
errorData: object
ErrorResponseData
-
result: object
result
The result object for successful requests. Type depends on the API operation.
-
status: string
Status of the response, either 'success' or an error indication.Example:
success
Nested Schema : result
Type:
objectThe result object for successful requests. Type depends on the API operation.
Example:
{
"hasMore":"true",
"totalResults":5,
"count":5,
"data":[
]
}Nested Schema : details
Type:
objectExamples