Bulk

Create Multiple Patients

post

Create Multiple Patients In a single api call

Authorizations

bearerAuth & organizationCodeapiKeyAuth & organizationCode

AuthorizationstringRequired

Enter your Bearer token

organization_codestringRequired

Enter your organization code

Bodyobject[]

application/json

object[]Optional

Responses

200Success

application/json

400

Bad request

401

Unauthorized

500

Internal server error

post

/api/service-provider-patients/bulk

HTTPcURLJavaScriptPython

POST /api/service-provider-patients/bulk HTTP/1.1
Host: platform-api-development.azo.dev
Authorization: Bearer YOUR_SECRET_TOKEN
organization_code: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 4

[
  {}
]

[
  {
    "id": "1",
    "firstName": "John",
    "lastName": "Doe",
    "middleName": "Michael",
    "birthDate": "1990-01-01",
    "timeZone": "GMT",
    "gender": "MALE",
    "email": "[email protected]",
    "mobileNumber": "[phone]",
    "addressLine1": "123 Main St",
    "addressLine2": "Apt 4B",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "country": "USA",
    "regionName": "Northeast",
    "consumerUuid": "uuid-1234",
    "externalId": "uuid-1234",
    "currency": "USD",
    "territory": "Territory 1",
    "secondaryEmail": "[email protected]",
    "secondaryPhone": "+0987654321",
    "mrn": "MRN123456",
    "department": "Cardiology",
    "organizationId": 123,
    "isPatient": true,
    "isPrimary": true,
    "relationship": [
      "Parent",
      "Sibling"
    ],
    "cdts": [
      {
        "name": "Example Name",
        "id": "12345",
        "multiRecord": true,
        "records": []
      }
    ],
    "dependants": [
      {
        "id": "1",
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Michael",
        "birthDate": "1990-01-01",
        "timeZone": "GMT",
        "gender": "MALE",
        "email": "[email protected]",
        "mobileNumber": "[phone]",
        "addressLine1": "123 Main St",
        "addressLine2": "Apt 4B",
        "city": "New York",
        "state": "NY",
        "zipCode": "10001",
        "country": "USA",
        "regionName": "Northeast",
        "consumerUuid": "uuid-1234",
        "externalId": "uuid-1234",
        "currency": "USD",
        "territory": "Territory 1",
        "secondaryEmail": "[email protected]",
        "secondaryPhone": "+0987654321",
        "mrn": "MRN123456",
        "department": "Cardiology",
        "organizationId": 123,
        "isPatient": true,
        "isPrimary": true,
        "relationship": [
          "Parent",
          "Sibling"
        ],
        "cdts": [
          {
            "name": "Example Name",
            "id": "12345",
            "multiRecord": true,
            "records": []
          }
        ],
        "dependants": [
          {
            "id": "1",
            "firstName": "John",
            "lastName": "Doe",
            "middleName": "Michael",
            "birthDate": "1990-01-01",
            "timeZone": "GMT",
            "gender": "MALE",
            "email": "[email protected]",
            "mobileNumber": "[phone]",
            "addressLine1": "123 Main St",
            "addressLine2": "Apt 4B",
            "city": "New York",
            "state": "NY",
            "zipCode": "10001",
            "country": "USA",
            "regionName": "Northeast",
            "consumerUuid": "uuid-1234",
            "externalId": "uuid-1234",
            "currency": "USD",
            "territory": "Territory 1",
            "secondaryEmail": "[email protected]",
            "secondaryPhone": "+0987654321",
            "mrn": "MRN123456",
            "department": "Cardiology",
            "organizationId": 123,
            "isPatient": true,
            "isPrimary": true,
            "relationship": [
              "Parent",
              "Sibling"
            ],
            "cdts": [
              {
                "name": "Example Name",
                "id": "12345",
                "multiRecord": true,
                "records": []
              }
            ],
            "dependants": "[Circular Reference]",
            "guardianId": 1,
            "guardians": "[Circular Reference]",
            "patientPrograms": [],
            "addresses": [
              {
                "id": 12,
                "title": "Title",
                "line1": "10 Riverside",
                "line2": "Drive Mira Loma",
                "country": "United States",
                "state": "New Jersey",
                "district": "Passaic County",
                "city": "Woodland Park",
                "addressType": "PRIMARY",
                "zipCode": "123456",
                "latitude": 12.34,
                "longitude": 12.34,
                "deleted": true,
                "createdAt": "2021-01-01",
                "updatedAt": "2021-01-01"
              }
            ],
            "attributes": {},
            "lastLoginAt": "2023-01-01T00:00:00Z",
            "profilePicFileId": 456,
            "profilePicture": "profile-pic-url",
            "profilePicFile": "[Circular Reference]",
            "isWelcomeEmailSent": true,
            "ehrProxyFields": {},
            "referrals": {},
            "populationTagIds": [],
            "populationTags": [],
            "tagsToAdd": [],
            "tagsToRemove": [],
            "relationshipType": "SELF",
            "careTeams": [],
            "forwardRelationship": [],
            "existingPatient": true,
            "relatedPatientId": 1
          }
        ],
        "guardianId": 1,
        "guardians": [
          {
            "id": "1",
            "firstName": "John",
            "lastName": "Doe",
            "middleName": "Michael",
            "birthDate": "1990-01-01",
            "timeZone": "GMT",
            "gender": "MALE",
            "email": "[email protected]",
            "mobileNumber": "[phone]",
            "addressLine1": "123 Main St",
            "addressLine2": "Apt 4B",
            "city": "New York",
            "state": "NY",
            "zipCode": "10001",
            "country": "USA",
            "regionName": "Northeast",
            "consumerUuid": "uuid-1234",
            "externalId": "uuid-1234",
            "currency": "USD",
            "territory": "Territory 1",
            "secondaryEmail": "[email protected]",
            "secondaryPhone": "+0987654321",
            "mrn": "MRN123456",
            "department": "Cardiology",
            "organizationId": 123,
            "isPatient": true,
            "isPrimary": true,
            "relationship": [
              "Parent",
              "Sibling"
            ],
            "cdts": [
              {
                "name": "Example Name",
                "id": "12345",
                "multiRecord": true,
                "records": []
              }
            ],
            "dependants": "[Circular Reference]",
            "guardianId": 1,
            "guardians": "[Circular Reference]",
            "patientPrograms": [],
            "addresses": [
              {
                "id": 12,
                "title": "Title",
                "line1": "10 Riverside",
                "line2": "Drive Mira Loma",
                "country": "United States",
                "state": "New Jersey",
                "district": "Passaic County",
                "city": "Woodland Park",
                "addressType": "PRIMARY",
                "zipCode": "123456",
                "latitude": 12.34,
                "longitude": 12.34,
                "deleted": true,
                "createdAt": "2021-01-01",
                "updatedAt": "2021-01-01"
              }
            ],
            "attributes": {},
            "lastLoginAt": "2023-01-01T00:00:00Z",
            "profilePicFileId": 456,
            "profilePicture": "profile-pic-url",
            "profilePicFile": "[Circular Reference]",
            "isWelcomeEmailSent": true,
            "ehrProxyFields": {},
            "referrals": {},
            "populationTagIds": [],
            "populationTags": [],
            "tagsToAdd": [],
            "tagsToRemove": [],
            "relationshipType": "SELF",
            "careTeams": [],
            "forwardRelationship": [],
            "existingPatient": true,
            "relatedPatientId": 1
          }
        ],
        "patientPrograms": [],
        "addresses": [
          {
            "id": 12,
            "title": "Title",
            "line1": "10 Riverside",
            "line2": "Drive Mira Loma",
            "country": "United States",
            "state": "New Jersey",
            "district": "Passaic County",
            "city": "Woodland Park",
            "addressType": "PRIMARY",
            "zipCode": "123456",
            "latitude": 12.34,
            "longitude": 12.34,
            "deleted": true,
            "createdAt": "2021-01-01",
            "updatedAt": "2021-01-01"
          }
        ],
        "attributes": {},
        "lastLoginAt": "2023-01-01T00:00:00Z",
        "profilePicFileId": 456,
        "profilePicture": "profile-pic-url",
        "profilePicFile": {
          "id": 1,
          "name": "text",
          "resource": null,
          "cloudId": "text",
          "cloudUrl": "text",
          "scanStatus": "text",
          "mimeType": "text",
          "personId": 1,
          "createdAt": "2025-12-15",
          "updatedAt": "2025-12-15",
          "attributes": {},
          "archived": true,
          "healthRecordAttributeFile": [
            {
              "id": 12,
              "fileId": 12,
              "healthRecordAttributeId": 12,
              "notes": "This is example file",
              "createdAt": "2023-03-02 07:14:19.987",
              "updatedAt": "2023-03-02 07:14:19.987"
            }
          ],
          "labels": {},
          "relatedFiles": [
            "[Circular Reference]"
          ],
          "relatedFile": [
            "[Circular Reference]"
          ],
          "isRelatedFile": true,
          "updatedBy": {},
          "person": {
            "id": 1,
            "firstName": "John",
            "lastName": "Doe",
            "birthDate": "1990-01-01",
            "gender": "MALE",
            "mobile": "[phone]",
            "email": "[email protected]",
            "uuid": "uuid-1234",
            "externalId": "external-1234",
            "currency": "USD",
            "consumer": "{}",
            "serviceProvider": "{}"
          }
        },
        "isWelcomeEmailSent": true,
        "ehrProxyFields": {},
        "referrals": {},
        "populationTagIds": [],
        "populationTags": [],
        "tagsToAdd": [],
        "tagsToRemove": [],
        "relationshipType": "SELF",
        "careTeams": [],
        "forwardRelationship": [],
        "existingPatient": true,
        "relatedPatientId": 1
      }
    ],
    "guardianId": 1,
    "guardians": [
      {
        "id": "1",
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Michael",
        "birthDate": "1990-01-01",
        "timeZone": "GMT",
        "gender": "MALE",
        "email": "[email protected]",
        "mobileNumber": "[phone]",
        "addressLine1": "123 Main St",
        "addressLine2": "Apt 4B",
        "city": "New York",
        "state": "NY",
        "zipCode": "10001",
        "country": "USA",
        "regionName": "Northeast",
        "consumerUuid": "uuid-1234",
        "externalId": "uuid-1234",
        "currency": "USD",
        "territory": "Territory 1",
        "secondaryEmail": "[email protected]",
        "secondaryPhone": "+0987654321",
        "mrn": "MRN123456",
        "department": "Cardiology",
        "organizationId": 123,
        "isPatient": true,
        "isPrimary": true,
        "relationship": [
          "Parent",
          "Sibling"
        ],
        "cdts": [
          {
            "name": "Example Name",
            "id": "12345",
            "multiRecord": true,
            "records": []
          }
        ],
        "dependants": "[Circular Reference]",
        "guardianId": 1,
        "guardians": "[Circular Reference]",
        "patientPrograms": [],
        "addresses": [
          {
            "id": 12,
            "title": "Title",
            "line1": "10 Riverside",
            "line2": "Drive Mira Loma",
            "country": "United States",
            "state": "New Jersey",
            "district": "Passaic County",
            "city": "Woodland Park",
            "addressType": "PRIMARY",
            "zipCode": "123456",
            "latitude": 12.34,
            "longitude": 12.34,
            "deleted": true,
            "createdAt": "2021-01-01",
            "updatedAt": "2021-01-01"
          }
        ],
        "attributes": {},
        "lastLoginAt": "2023-01-01T00:00:00Z",
        "profilePicFileId": 456,
        "profilePicture": "profile-pic-url",
        "profilePicFile": "[Circular Reference]",
        "isWelcomeEmailSent": true,
        "ehrProxyFields": {},
        "referrals": {},
        "populationTagIds": [],
        "populationTags": [],
        "tagsToAdd": [],
        "tagsToRemove": [],
        "relationshipType": "SELF",
        "careTeams": [],
        "forwardRelationship": [],
        "existingPatient": true,
        "relatedPatientId": 1
      }
    ],
    "patientPrograms": [],
    "addresses": [
      {
        "id": 12,
        "title": "Title",
        "line1": "10 Riverside",
        "line2": "Drive Mira Loma",
        "country": "United States",
        "state": "New Jersey",
        "district": "Passaic County",
        "city": "Woodland Park",
        "addressType": "PRIMARY",
        "zipCode": "123456",
        "latitude": 12.34,
        "longitude": 12.34,
        "deleted": true,
        "createdAt": "2021-01-01",
        "updatedAt": "2021-01-01"
      }
    ],
    "attributes": {},
    "lastLoginAt": "2023-01-01T00:00:00Z",
    "profilePicFileId": 456,
    "profilePicture": "profile-pic-url",
    "profilePicFile": {
      "id": 1,
      "name": "text",
      "resource": null,
      "cloudId": "text",
      "cloudUrl": "text",
      "scanStatus": "text",
      "mimeType": "text",
      "personId": 1,
      "createdAt": "2025-12-15",
      "updatedAt": "2025-12-15",
      "attributes": {},
      "archived": true,
      "healthRecordAttributeFile": [
        {
          "id": 12,
          "fileId": 12,
          "healthRecordAttributeId": 12,
          "notes": "This is example file",
          "createdAt": "2023-03-02 07:14:19.987",
          "updatedAt": "2023-03-02 07:14:19.987"
        }
      ],
      "labels": {},
      "relatedFiles": [
        "[Circular Reference]"
      ],
      "relatedFile": [
        "[Circular Reference]"
      ],
      "isRelatedFile": true,
      "updatedBy": {},
      "person": {
        "id": 1,
        "firstName": "John",
        "lastName": "Doe",
        "birthDate": "1990-01-01",
        "gender": "MALE",
        "mobile": "[phone]",
        "email": "[email protected]",
        "uuid": "uuid-1234",
        "externalId": "external-1234",
        "currency": "USD",
        "consumer": "{}",
        "serviceProvider": "{}"
      }
    },
    "isWelcomeEmailSent": true,
    "ehrProxyFields": {},
    "referrals": {},
    "populationTagIds": [],
    "populationTags": [],
    "tagsToAdd": [],
    "tagsToRemove": [],
    "relationshipType": "SELF",
    "careTeams": [],
    "forwardRelationship": [],
    "existingPatient": true,
    "relatedPatientId": 1
  }
]