Creates a new patient policy.

post

https://integrationhub.wellsky.io/commands/v4/patients/policies

Sample request:

POST /commands/v4/patients/policies
{
    "medicalRecordNumber": "MRN001",
    "carrierId": 100,
    "policyNumber": "POL123456",
    "groupNumber": "GRP789",
    "planName": "Medicare Part D",
    "effectiveDate": "2024-01-01",
    "sequence": 1
}

HCSI-XXXX: Create patient policy endpoint.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

api-version

string

The requested API version

Body Params

The patient policy information to create.

Request model for creating a new patient policy.

medicalRecordNumber

string

required

length ≥ 1

Medical record number of the patient. Required.

carrierId

int64

required

≥ 1

Unique identifier of the carrier (insurance company). Required.

policyOwnerId

int64 | null

≥ 1

Unique identifier of the policy owner.

policyContactId

int64 | null

≥ 1

Unique identifier of the policy contact.

employerId

int64 | null

≥ 1

Unique identifier of the employer.

policyNumber

string | null

Policy number.

groupNumber

string | null

Group number.

insuredId

string | null

Insured ID number.

planName

string | null

Plan name of the patient policy.

planId

string | null

Plan ID of the patient policy.

effectiveDate

date-time | null

Effective date of the patient policy.

expirationDate

date-time | null

Expiration date of the patient policy.

sequence

int32 | null

1 to 2147483647

Policy sequence number. Defaults to 1 if not provided.

patientRelationToInsured

string | null

Patient relation to insured (e.g., Self, Spouse, Child).

insuranceProgram

string | null

Insurance program name (e.g., MEDICARE, MEDICAID).

carrierBINPCNId

int64 | null

≥ 1

Unique identifier of the carrier BIN/PCN.

nextPayerId

int64 | null

≥ 1

Unique identifier of the next payer (for secondary coverage).

isBillForDenial

boolean

Bill for denial flag.

medicaidNumber

string | null

Medicaid number.

submissionClarificationCode

string | null

Submission clarification code (01-10).

personCode

string | null

Person code.

isResidesInCMSPartDFacility

boolean

Resides in CMS Part D facility flag.

dateOfInjury

date-time | null

Date of injury.

onsetDate

date-time | null

Onset date.

causeOfInjury

string | null

Cause of injury (e.g., AutoAccident, WorkInjury).

causeOfInjuryState

string | null

Cause of injury state code.

claimCode

string | null

Claim code.

unableToWorkStart

date-time | null

Unable to work start date.

unableToWorkEnd

date-time | null

Unable to work end date.

isMedicalSecondaryToMedicare

boolean

Medical secondary to medicare flag.

propertyCasualtyClaimNumber

string | null

Property casualty claim number.

mspTypeCode

string | null

Medicare secondary provider type code.

signatureSource

string | null

Signature source code.

releaseOfInfoCode

string | null

Release of information code.

papPatientResponsibility

double | null

≥ 0

PAP patient responsibility amount.

papStatus

string | null

PAP status (e.g., Pending, Approved, Inactive, Denied).

papHouseholdIncome

double | null

≥ 0

PAP household income amount.

papNumberOfDependents

int32 | null

0 to 2147483647

PAP number of dependents.

isPrimary

boolean

Is primary policy flag.

patientFirstName

string | null

Patient first name on policy.

patientLastName

string | null

Patient last name on policy.

Headers

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json