> ## Documentation Index
> Fetch the complete documentation index at: https://dev.ownright.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Status Certificate Review Referral Bulk Create

> Creates multiple status certificate review referrals.

<RequestExample>
  ```graphql Request [expandable] theme={null}
  mutation StatusCertificateReviewReferralBulkCreate($input: [StatusCertificateReviewReferralInput!]!) {
    statusCertificateReviewReferralBulkCreate(input: $input) {
      referrals {
        clientHasMadeOffer
        createdAt
        earlyDeadlineRequest
        id
        preferredCompletionTime
        status
        type
        updatedAt
        contacts {
          email
          firstName
          id
          isPrimary
          lastName
          phoneNumber
        }
        customAttributes {
          id
          key
          type
          value
        }
        primaryContact {
          email
          firstName
          id
          isPrimary
          lastName
          phoneNumber
        }
        propertyAddress {
          city
          country
          latitude
          longitude
          mapImageUrl
          postalCode
          province
          shortTitle
          street
          title
          unitNumber
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
  ```

  ```graphql Variables theme={null}
  {
    "input": [
      {
        "clientHasMadeOffer": true,
        "contacts": [
          {
            "email": "jane@example.com",
            "firstName": "Jane",
            "lastName": "Doe",
            "phoneNumber": "+14165551234",
            "primary": true
          }
        ],
        "customAttributes": [
          {
            "key": "example-key",
            "type": "BOOLEAN",
            "value": "example-value"
          }
        ],
        "earlyDeadlineRequest": true,
        "files": [
          {
            "fileRecordId": "gid://ownright/FileRecord/1",
            "tags": [
              "example-tags"
            ]
          }
        ],
        "intentLevel": "HIGH",
        "preferredCompletionTime": "2025-01-15T10:30:00Z",
        "propertyAddress": {
          "city": "Toronto",
          "country": "CANADA",
          "postalCode": "M5V 1A1",
          "province": "ALBERTA",
          "street": "123 Main St",
          "unitNumber": "Suite 100"
        }
      }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "statusCertificateReviewReferralBulkCreate": {
        "referrals": [
          {
            "clientHasMadeOffer": true,
            "createdAt": "2025-01-15T10:30:00Z",
            "earlyDeadlineRequest": true,
            "id": "gid://ownright/Object/1",
            "preferredCompletionTime": "2025-01-15T10:30:00Z",
            "status": "CONVERTED",
            "type": "PURCHASE_PROPERTY_CLOSING",
            "updatedAt": "2025-01-15T10:30:00Z",
            "contacts": [
              {
                "email": "jane@example.com",
                "firstName": "Jane",
                "id": "gid://ownright/Object/1",
                "isPrimary": true,
                "lastName": "Doe",
                "phoneNumber": "+14165551234"
              }
            ],
            "customAttributes": [
              {
                "id": "gid://ownright/Object/1",
                "key": "example-key",
                "type": "BOOLEAN",
                "value": "example-value"
              }
            ],
            "primaryContact": {
              "email": "jane@example.com",
              "firstName": "Jane",
              "id": "gid://ownright/Object/1",
              "isPrimary": true,
              "lastName": "Doe",
              "phoneNumber": "+14165551234"
            },
            "propertyAddress": {
              "city": "Toronto",
              "country": "CANADA",
              "latitude": 1,
              "longitude": 1,
              "mapImageUrl": "https://example.com",
              "postalCode": "M5V 1A1",
              "province": "ALBERTA",
              "shortTitle": "123 Main St, Toronto",
              "street": "123 Main St",
              "title": "123 Main St, Toronto",
              "unitNumber": "Suite 100"
            }
          }
        ],
        "userErrors": []
      }
    }
  }
  ```
</ResponseExample>

## Mutation field

`statusCertificateReviewReferralBulkCreate`

### Arguments

<ParamField path="input" type="[StatusCertificateReviewReferralInput!]!" required>
  Input required to create status certificate review referrals.

  <Expandable title="properties">
    <ParamField path="clientHasMadeOffer" type="Boolean">
      Whether or not the client has made an offer on the property already.
    </ParamField>

    <ParamField path="contacts" type="[ReferralContactCreateInput!]!" required>
      Contacts to be associated with the referral.

      <Expandable title="properties">
        <ParamField path="email" type="String!" required>
          The email for the referral contact.
        </ParamField>

        <ParamField path="firstName" type="String!" required>
          The first name for the referral contact.
        </ParamField>

        <ParamField path="lastName" type="String">
          The last name for the referral contact.
        </ParamField>

        <ParamField path="phoneNumber" type="String">
          The phone number for the referral contact.
        </ParamField>

        <ParamField path="primary" type="Boolean!" required>
          Whether this contact is the primary contact for the referral.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="customAttributes" type="[CustomAttributeCreateInput!]">
      Custom attributes to be associated with the referral.

      <Expandable title="properties">
        <ParamField path="key" type="String!" required>
          The key of the custom attribute.
        </ParamField>

        <ParamField path="type" type="CustomAttributeType!" required>
          The type of the custom attribute.
        </ParamField>

        <ParamField path="value" type="String!" required>
          The value of the custom attribute.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="earlyDeadlineRequest" type="Boolean">
      Whether or not the status certificate review requires an earlier than normal
      review.
    </ParamField>

    <ParamField path="files" type="[FileBulkCommitInput!]!" required>
      The files to be associated with the referral.

      <Expandable title="properties">
        <ParamField path="fileRecordId" type="FileRecordGID!" required>
          The identifier of a staged file record to commit.
        </ParamField>

        <ParamField path="tags" type="[String!]!" required>
          Tags to add to the committed versioned file.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="intentLevel" type="ReferralIntentLevel">
      The intent level of the referral.
    </ParamField>

    <ParamField path="preferredCompletionTime" type="ISO8601DateTime">
      The preferred completion time for the status certificate review.
    </ParamField>

    <ParamField path="propertyAddress" type="AddressInput!" required>
      The address of the property for which the status certificate review is being requested.

      <Expandable title="properties">
        <ParamField path="city" type="String">
          The city of the address.
        </ParamField>

        <ParamField path="country" type="Country">
          The country of the address.
        </ParamField>

        <ParamField path="postalCode" type="String">
          The postal code of the address.
        </ParamField>

        <ParamField path="province" type="Province">
          The province of the address.
        </ParamField>

        <ParamField path="street" type="String">
          The street name and number of the address.
        </ParamField>

        <ParamField path="unitNumber" type="String">
          The unit number, suite number, apartment number, etc. of the address.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

### Return fields

<ResponseField name="referrals" type="[StatusCertificateReviewReferral!]">
  The created referrals.

  <Expandable title="properties">
    <ResponseField name="clientHasMadeOffer" type="Boolean!" required>
      Indicates whether the client has made an offer on a property already or not.
    </ResponseField>

    <ResponseField name="contacts" type="[ReferralContact!]!" required>
      The contacts for the referral.

      <Expandable title="properties">
        <ResponseField name="email" type="String!" required>
          The email of the contact.
        </ResponseField>

        <ResponseField name="firstName" type="String!" required>
          The first name of the contact.
        </ResponseField>

        <ResponseField name="id" type="GID!" required>
          ID of the object.
        </ResponseField>

        <ResponseField name="isPrimary" type="Boolean!" required>
          Whether the contact is the primary contact.
        </ResponseField>

        <ResponseField name="lastName" type="String">
          The last name of the contact.
        </ResponseField>

        <ResponseField name="phoneNumber" type="String">
          The phone number of the contact.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="createdAt" type="ISO8601DateTime!" required>
      The time the referral was created.
    </ResponseField>

    <ResponseField name="customAttributes" type="[CustomAttribute!]!" required>
      The custom attributes for the referral.

      <Expandable title="properties">
        <ResponseField name="id" type="GID!" required>
          ID of the object.
        </ResponseField>

        <ResponseField name="key" type="String!" required>
          The key of the custom attribute.
        </ResponseField>

        <ResponseField name="type" type="CustomAttributeType!" required>
          The type of the custom attribute.
        </ResponseField>

        <ResponseField name="value" type="String!" required>
          The value of the custom attribute.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="earlyDeadlineRequest" type="Boolean!" required>
      Indicates whether the status certificate review requires an earlier than
      normal review.
    </ResponseField>

    <ResponseField name="id" type="GID!" required>
      ID of the object.
    </ResponseField>

    <ResponseField name="preferredCompletionTime" type="ISO8601DateTime">
      The preferred completion time for the status certificate review.
    </ResponseField>

    <ResponseField name="primaryContact" type="ReferralContact!" required>
      The primary contact for the referral.

      <Expandable title="properties">
        <ResponseField name="email" type="String!" required>
          The email of the contact.
        </ResponseField>

        <ResponseField name="firstName" type="String!" required>
          The first name of the contact.
        </ResponseField>

        <ResponseField name="id" type="GID!" required>
          ID of the object.
        </ResponseField>

        <ResponseField name="isPrimary" type="Boolean!" required>
          Whether the contact is the primary contact.
        </ResponseField>

        <ResponseField name="lastName" type="String">
          The last name of the contact.
        </ResponseField>

        <ResponseField name="phoneNumber" type="String">
          The phone number of the contact.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="propertyAddress" type="Address">
      The address of the property that is involved in the status certificate review.

      <Expandable title="properties">
        <ResponseField name="city" type="String!" required>
          The city of the address.
        </ResponseField>

        <ResponseField name="country" type="Country!" required>
          The country of the address.
        </ResponseField>

        <ResponseField name="latitude" type="Float">
          The latitude of the address.
        </ResponseField>

        <ResponseField name="longitude" type="Float">
          The longitude of the address.
        </ResponseField>

        <ResponseField name="mapImageUrl" type="Url">
          A link to a map with a pointer on the address's location.
        </ResponseField>

        <ResponseField name="postalCode" type="String!" required>
          The postal code of the address.
        </ResponseField>

        <ResponseField name="province" type="Province!" required>
          The province of the address.
        </ResponseField>

        <ResponseField name="shortTitle" type="String!" required>
          The shortened title for the address.
        </ResponseField>

        <ResponseField name="street" type="String!" required>
          The street name and number of the address.
        </ResponseField>

        <ResponseField name="title" type="String!" required>
          The full title for the address.
        </ResponseField>

        <ResponseField name="unitNumber" type="String">
          The unit number, apartment number, suite number etc.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="ReferralStatus!" required>
      The current status of the referral.
    </ResponseField>

    <ResponseField name="type" type="ReferralType!" required>
      The type of the referral.
    </ResponseField>

    <ResponseField name="updatedAt" type="ISO8601DateTime!" required>
      The time the referral was updated.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="userErrors" type="[StatusCertificateReviewReferralBulkCreateUserError!]!" required>
  List of errors that occurred while executing the mutation.

  <Expandable title="properties">
    <ResponseField name="code" type="StatusCertificateReviewReferralBulkCreateUserErrorCode">
      Error code associated with the error.
    </ResponseField>

    <ResponseField name="field" type="[String!]">
      The path to the input field that caused the error.
    </ResponseField>

    <ResponseField name="message" type="String!" required>
      A description of the error.
    </ResponseField>
  </Expandable>
</ResponseField>

### Types

* [`Address`](/partner-api/reference/members/objects/address) (object) — Represents an address.
* [`AddressInput`](/partner-api/reference/members/inputs/address-input) (input) — Input to create or update an address.
* [`Country`](/partner-api/reference/members/enums/country) (enum) — Possible countries.
* [`CustomAttribute`](/partner-api/reference/members/objects/custom-attribute) (object) — A custom attribute.
* [`CustomAttributeCreateInput`](/partner-api/reference/members/inputs/custom-attribute-create-input) (input) — Input to create a custom attribute.
* [`CustomAttributeType`](/partner-api/reference/members/enums/custom-attribute-type) (enum) — Possible custom attribute types.
* [`FileBulkCommitInput`](/partner-api/reference/members/inputs/file-bulk-commit-input) (input) — Input for a file to committed as part of a bulk file commit.
* [`FileRecordGID`](/partner-api/reference/members/scalars/file-record-gid) (scalar) — A global identifier for a FileRecord object in format of 'gid://ownright/FileRecord/ID'.
* [`GID`](/partner-api/reference/members/scalars/gid) (scalar) — A global identifier for an object in the format of 'gid://ownright/ObjectType/ID'.
* [`ISO8601DateTime`](/partner-api/reference/members/scalars/iso8601-date-time) (scalar) — An ISO 8601-encoded datetime
* [`ImageTransformInput`](/partner-api/reference/members/inputs/image-transform-input) (input) — Input to transform an image.
* [`Province`](/partner-api/reference/members/enums/province) (enum) — Possible provinces.
* [`ReferralContact`](/partner-api/reference/members/objects/referral-contact) (object) — A contact for a referral.
* [`ReferralContactCreateInput`](/partner-api/reference/members/inputs/referral-contact-create-input) (input) — The input to create a referral contact.
* [`ReferralIntentLevel`](/partner-api/reference/members/enums/referral-intent-level) (enum) — Possible levels of intent for a referral.
* [`ReferralStatus`](/partner-api/reference/members/enums/referral-status) (enum) — Possible statuses for referrals.
* [`ReferralType`](/partner-api/reference/members/enums/referral-type) (enum) — Possible types of referrals.
* [`StatusCertificateReviewReferral`](/partner-api/reference/members/objects/status-certificate-review-referral) (object) — A referral for a status certificate review.
* [`StatusCertificateReviewReferralBulkCreatePayload`](/partner-api/reference/members/objects/status-certificate-review-referral-bulk-create-payload) (object) — Return type for the `statusCertificateReviewReferralBulkCreate` mutation.
* [`StatusCertificateReviewReferralBulkCreateUserError`](/partner-api/reference/members/objects/status-certificate-review-referral-bulk-create-user-error) (object) — An error that could occur during the execution of the `statusCertificateReviewReferralBulkCreate` mutation.
* [`StatusCertificateReviewReferralBulkCreateUserErrorCode`](/partner-api/reference/members/enums/status-certificate-review-referral-bulk-create-user-error-code) (enum) — Possible error codes that can be returned by StatusCertificateReviewReferralBulkCreateUserError.
* [`StatusCertificateReviewReferralInput`](/partner-api/reference/members/inputs/status-certificate-review-referral-input) (input) — Input to create a status certificate review referral.
* [`Url`](/partner-api/reference/members/scalars/url) (scalar) — A valid URL, transported as a string.