Skip to main content
PATCH
/
v2
/
customers
/
{id}
Update customer by ID
curl --request PATCH \
  --url https://api.carecycle.ai/v2/customers/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "clientCustomerId": "<string>",
  "status": "Lead",
  "qualificationStatus": "Qualified",
  "intent": "High",
  "isDecisionMaker": true,
  "disqualificationReason": "<string>",
  "productInterest": "<string>",
  "productFamily": "<string>",
  "salutation": "<string>",
  "suffix": "<string>",
  "firstName": "<string>",
  "middleName": "<string>",
  "lastName": "<string>",
  "preferredName": "<string>",
  "callerId": "<string>",
  "lineType": "landline",
  "email": "<string>",
  "dateOfBirth": "<string>",
  "language": "<string>",
  "ethnicity": "<string>",
  "gender": "Male",
  "maritalStatus": "Single",
  "postalCode": "<string>",
  "timezone": "<string>",
  "state": "<string>",
  "city": "<string>",
  "county": "<string>",
  "address": "<string>",
  "address2": "<string>",
  "mbiNumber": "<string>",
  "medicareCard": true,
  "medicarePartADate": "<string>",
  "medicarePartBDate": "<string>",
  "medicaid": true,
  "medicaidNumber": "<string>",
  "socialSecurityDisability": true,
  "veteran": true,
  "vaNumber": "<string>",
  "healthSherpaCustomerId": "<string>",
  "householdIncome": -1,
  "annualIncome": -1,
  "filingStatus": "<string>",
  "dependentCount": -1,
  "subsidyAmount": -1,
  "subsidyEligible": true,
  "existingCoverage": "None",
  "existingCoveragePlanName": "<string>",
  "existingCoverageCarrier": "<string>",
  "desiredCoverageStartDate": "<string>",
  "currentSourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "originalSourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agentName": "<string>",
  "agentNpn": -1,
  "memberId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customData": "<string>",
  "carrierName": "<string>",
  "planName": "<string>",
  "planCode": "<string>",
  "enrollmentDate": "<string>",
  "effectiveDate": "<string>",
  "carrierAssignedCustomerId": "<string>",
  "doNotCall": true,
  "doNotSMS": true,
  "doNotEmail": true,
  "doNotMail": true,
  "lastContactedAt": "<string>",
  "convertedAt": "<string>",
  "deleted": true,
  "deletedAt": "<string>",
  "deletedByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "<string>",
  "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedAt": "<string>",
  "updatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "clientCustomerId": "<string>",
  "status": "Lead",
  "qualificationStatus": "Qualified",
  "intent": "High",
  "isDecisionMaker": true,
  "disqualificationReason": "<string>",
  "productInterest": "<string>",
  "productFamily": "<string>",
  "salutation": "<string>",
  "suffix": "<string>",
  "firstName": "<string>",
  "middleName": "<string>",
  "lastName": "<string>",
  "preferredName": "<string>",
  "callerId": "<string>",
  "lineType": "landline",
  "email": "<string>",
  "dateOfBirth": "<string>",
  "language": "<string>",
  "ethnicity": "<string>",
  "gender": "Male",
  "maritalStatus": "Single",
  "postalCode": "<string>",
  "timezone": "<string>",
  "state": "<string>",
  "city": "<string>",
  "county": "<string>",
  "address": "<string>",
  "address2": "<string>",
  "mbiNumber": "<string>",
  "medicareCard": true,
  "medicarePartADate": "<string>",
  "medicarePartBDate": "<string>",
  "medicaid": true,
  "medicaidNumber": "<string>",
  "socialSecurityDisability": true,
  "veteran": true,
  "vaNumber": "<string>",
  "healthSherpaCustomerId": "<string>",
  "householdIncome": -1,
  "annualIncome": -1,
  "filingStatus": "<string>",
  "dependentCount": -1,
  "subsidyAmount": -1,
  "subsidyEligible": true,
  "existingCoverage": "None",
  "existingCoveragePlanName": "<string>",
  "existingCoverageCarrier": "<string>",
  "desiredCoverageStartDate": "<string>",
  "currentSourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "originalSourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agentName": "<string>",
  "agentNpn": -1,
  "memberId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "carrierName": "<string>",
  "planName": "<string>",
  "planCode": "<string>",
  "enrollmentDate": "<string>",
  "effectiveDate": "<string>",
  "carrierAssignedCustomerId": "<string>",
  "doNotCall": true,
  "doNotSMS": true,
  "doNotEmail": true,
  "doNotMail": true,
  "lastContactedAt": "<string>",
  "convertedAt": "<string>"
}

Authorizations

​
x-api-key
string
header
required

API key required for authentication.

Keys begin with 'cc_' prefix. Get your API key from the Developer Dashboard.

Path Parameters

​
id
string<uuid>
required

Customer ID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json

PATCH /v2/customers/:id Request body

​
createdBy
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
updatedBy
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
clientId
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
clientCustomerId
string | null
Maximum string length: 255
​
status
enum<string> | null
Available options:
Lead,
Active,
Inactive
​
qualificationStatus
enum<string> | null
Available options:
Qualified,
Disqualified,
Pending Review,
Needs Information,
In Progress
​
intent
enum<string> | null
Available options:
High,
Medium,
Low,
Unknown
​
isDecisionMaker
boolean | null
​
disqualificationReason
string | null
Maximum string length: 255
​
productInterest
string | null
Maximum string length: 255
​
productFamily
string | null
Maximum string length: 255
​
salutation
string | null
Maximum string length: 50
​
suffix
string | null
Maximum string length: 50
​
firstName
string | null
Maximum string length: 255
​
middleName
string | null
Maximum string length: 255
​
lastName
string | null
Maximum string length: 255
​
preferredName
string | null
Maximum string length: 255
​
callerId
string
Maximum string length: 255
​
lineType
enum<string> | null
Available options:
landline,
mobile,
fixedVoip,
nonFixedVoip,
personal,
tollFree,
premium,
sharedCost,
uan,
voicemail,
pager,
unknown
​
email
string | null
Maximum string length: 255
​
dateOfBirth
string | null
​
language
string | null
Maximum string length: 50
​
ethnicity
string | null
Maximum string length: 50
​
gender
enum<string> | null
Available options:
Male,
Female,
Non-Binary,
Other,
Prefer Not to Say
​
maritalStatus
enum<string> | null
Available options:
Single,
Married,
Divorced,
Widowed,
Separated,
Domestic Partnership
​
postalCode
string | null
Maximum string length: 20
​
timezone
string | null
Maximum string length: 50
​
state
string | null
Maximum string length: 50
​
city
string | null
Maximum string length: 255
​
county
string | null
Maximum string length: 255
​
address
string | null
Maximum string length: 255
​
address2
string | null
Maximum string length: 255
​
mbiNumber
string | null
Maximum string length: 255
​
medicareCard
boolean | null
​
medicarePartADate
string | null
​
medicarePartBDate
string | null
​
medicaid
boolean | null
​
medicaidNumber
string | null
Maximum string length: 255
​
socialSecurityDisability
boolean | null
​
veteran
boolean | null
​
vaNumber
string | null
Maximum string length: 255
​
healthSherpaCustomerId
string | null
Maximum string length: 255
​
householdIncome
integer | null
Required range: -2147483648 <= x <= 2147483647
​
annualIncome
integer | null
Required range: -2147483648 <= x <= 2147483647
​
filingStatus
string | null
Maximum string length: 50
​
dependentCount
integer | null
Required range: -2147483648 <= x <= 2147483647
​
subsidyAmount
integer | null
Required range: -2147483648 <= x <= 2147483647
​
subsidyEligible
boolean | null
​
existingCoverage
enum<string> | null
Available options:
None,
Medicare Advantage,
Original Medicare,
Medicaid,
Employer,
Marketplace/ACA,
Other
​
existingCoveragePlanName
string | null
Maximum string length: 255
​
existingCoverageCarrier
string | null
Maximum string length: 255
​
desiredCoverageStartDate
string | null
​
currentSourceId
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
originalSourceId
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
agentName
string | null
Maximum string length: 255
​
agentNpn
integer | null
Required range: -2147483648 <= x <= 2147483647
​
memberId
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
customData
​
carrierName
string | null
Maximum string length: 255
​
planName
string | null
Maximum string length: 255
​
planCode
string | null
Maximum string length: 255
​
enrollmentDate
string | null
​
effectiveDate
string | null
​
carrierAssignedCustomerId
string | null
Maximum string length: 255
​
doNotCall
boolean | null
​
doNotSMS
boolean | null
​
doNotEmail
boolean | null
​
doNotMail
boolean | null
​
lastContactedAt
string | null
​
convertedAt
string | null
​
deleted
boolean
​
deletedAt
string | null
​
deletedByUserId
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

PATCH /v2/customers/:id Positive response

Updated customer record

​
id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
createdAt
string | null
required
​
createdBy
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
updatedAt
string | null
required
​
updatedBy
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
clientId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
clientCustomerId
string | null
required
Maximum string length: 255
​
status
enum<string> | null
required
Available options:
Lead,
Active,
Inactive
​
qualificationStatus
enum<string> | null
required
Available options:
Qualified,
Disqualified,
Pending Review,
Needs Information,
In Progress
​
intent
enum<string> | null
required
Available options:
High,
Medium,
Low,
Unknown
​
isDecisionMaker
boolean | null
required
​
disqualificationReason
string | null
required
Maximum string length: 255
​
productInterest
string | null
required
Maximum string length: 255
​
productFamily
string | null
required
Maximum string length: 255
​
salutation
string | null
required
Maximum string length: 50
​
suffix
string | null
required
Maximum string length: 50
​
firstName
string | null
required
Maximum string length: 255
​
middleName
string | null
required
Maximum string length: 255
​
lastName
string | null
required
Maximum string length: 255
​
preferredName
string | null
required
Maximum string length: 255
​
callerId
string
required
Maximum string length: 255
​
lineType
enum<string> | null
required
Available options:
landline,
mobile,
fixedVoip,
nonFixedVoip,
personal,
tollFree,
premium,
sharedCost,
uan,
voicemail,
pager,
unknown
​
email
string | null
required
Maximum string length: 255
​
dateOfBirth
string | null
required
​
language
string | null
required
Maximum string length: 50
​
ethnicity
string | null
required
Maximum string length: 50
​
gender
enum<string> | null
required
Available options:
Male,
Female,
Non-Binary,
Other,
Prefer Not to Say
​
maritalStatus
enum<string> | null
required
Available options:
Single,
Married,
Divorced,
Widowed,
Separated,
Domestic Partnership
​
postalCode
string | null
required
Maximum string length: 20
​
timezone
string | null
required
Maximum string length: 50
​
state
string | null
required
Maximum string length: 50
​
city
string | null
required
Maximum string length: 255
​
county
string | null
required
Maximum string length: 255
​
address
string | null
required
Maximum string length: 255
​
address2
string | null
required
Maximum string length: 255
​
mbiNumber
string | null
required
Maximum string length: 255
​
medicareCard
boolean | null
required
​
medicarePartADate
string | null
required
​
medicarePartBDate
string | null
required
​
medicaid
boolean | null
required
​
medicaidNumber
string | null
required
Maximum string length: 255
​
socialSecurityDisability
boolean | null
required
​
veteran
boolean | null
required
​
vaNumber
string | null
required
Maximum string length: 255
​
healthSherpaCustomerId
string | null
required
Maximum string length: 255
​
householdIncome
integer | null
required
Required range: -2147483648 <= x <= 2147483647
​
annualIncome
integer | null
required
Required range: -2147483648 <= x <= 2147483647
​
filingStatus
string | null
required
Maximum string length: 50
​
dependentCount
integer | null
required
Required range: -2147483648 <= x <= 2147483647
​
subsidyAmount
integer | null
required
Required range: -2147483648 <= x <= 2147483647
​
subsidyEligible
boolean | null
required
​
existingCoverage
enum<string> | null
required
Available options:
None,
Medicare Advantage,
Original Medicare,
Medicaid,
Employer,
Marketplace/ACA,
Other
​
existingCoveragePlanName
string | null
required
Maximum string length: 255
​
existingCoverageCarrier
string | null
required
Maximum string length: 255
​
desiredCoverageStartDate
string | null
required
​
currentSourceId
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
originalSourceId
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
agentName
string | null
required
Maximum string length: 255
​
agentNpn
integer | null
required
Required range: -2147483648 <= x <= 2147483647
​
memberId
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
carrierName
string | null
required
Maximum string length: 255
​
planName
string | null
required
Maximum string length: 255
​
planCode
string | null
required
Maximum string length: 255
​
enrollmentDate
string | null
required
​
effectiveDate
string | null
required
​
carrierAssignedCustomerId
string | null
required
Maximum string length: 255
​
doNotCall
boolean | null
required
​
doNotSMS
boolean | null
required
​
doNotEmail
boolean | null
required
​
doNotMail
boolean | null
required
​
lastContactedAt
string | null
required
​
convertedAt
string | null
required