Skip to main content
mutation PropertyClosingReferralBulkCreate($input: [PropertyClosingReferralInput!]!) {
  propertyClosingReferralBulkCreate(input: $input) {
    referrals {
      createdAt
      id
      status
      type
      updatedAt
      contacts {
        email
        firstName
        id
        isPrimary
        lastName
        phoneNumber
      }
      customAttributes {
        id
        key
        type
        value
      }
      primaryContact {
        email
        firstName
        id
        isPrimary
        lastName
        phoneNumber
      }
      ... on PurchasePropertyClosingReferral {
        propertyAddress {
          city
          country
          latitude
          longitude
          mapImageUrl
          postalCode
          province
          shortTitle
          street
          title
          unitNumber
        }
        purchaseAmount {
          amount
          currencyCode
        }
      }
      ... on RefinanceReferral {
        mortgageAmount {
          amount
          currencyCode
        }
        propertyAddress {
          city
          country
          latitude
          longitude
          mapImageUrl
          postalCode
          province
          shortTitle
          street
          title
          unitNumber
        }
      }
      ... on SalePropertyClosingReferral {
        propertyAddress {
          city
          country
          latitude
          longitude
          mapImageUrl
          postalCode
          province
          shortTitle
          street
          title
          unitNumber
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}
{
  "data": {
    "propertyClosingReferralBulkCreate": {
      "referrals": [
        {
          "createdAt": "2025-01-15T10:30:00Z",
          "id": "gid://ownright/Object/1",
          "status": "CONVERTED",
          "type": "PURCHASE_PROPERTY_CLOSING",
          "updatedAt": "2025-01-15T10:30:00Z",
          "contacts": [
            {
              "email": "[email protected]",
              "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": "[email protected]",
            "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"
          },
          "purchaseAmount": {
            "amount": "100.00",
            "currencyCode": "CAD"
          },
          "mortgageAmount": {
            "amount": "100.00",
            "currencyCode": "CAD"
          }
        }
      ],
      "userErrors": []
    }
  }
}

Mutation field

propertyClosingReferralBulkCreate

Arguments

input
[PropertyClosingReferralInput!]!
required
Input required to create property closing referrals.

Return fields

referrals
[Referral!]
The created referrals.
userErrors
[PropertyClosingReferralBulkCreateUserError!]!
required
List of errors that occurred while executing the mutation.

Types

enum Country {
  CANADA # Represents Canada the country.
}

enum CurrencyCode {
  CAD # Represents the CAD currency code.
  USD # Represents the USD currency code.
}

enum CustomAttributeType {
  BOOLEAN # A boolean value ("true" or "false").
  COLOR # A hex color code starting with # (e.g., "#FF0000" or "#F00").
  DATE # A date in ISO8601 format (YYYY-MM-DD, e.g., "2024-03-19").
  DATE_TIME # A datetime in ISO8601 format with timezone (YYYY-MM-DDThh:mm:ssZ, e.g., "2024-03-19T12:00:00Z").
  EMAIL # A valid email address (e.g., "[email protected]").
  FLOAT # A decimal number value (e.g., "3.14").
  INTEGER # A whole number value (e.g., "42").
  JSON # A valid JSON value of any type.
  MONEY # A money value as a JSON object with amount and currency code (e.g., {"amount": "10.99", "currency_code": "CAD"}).
  PHONE_NUMBER # A valid E.164 phone number (e.g., "+1234567890").
  STRING # A simple text value.
  URL # A valid HTTP or HTTPS URL (e.g., "https://example.com").
}

enum PropertyClosingReferralBulkCreateUserErrorCode {
  FILE_RECORD_NOT_FOUND # One of the supplied file records could not be found.
  FILE_RECORD_NOT_STAGED # One the supplied file records is not staged.
  INVALID_REFERRAL_INPUT # The supplied referral input is invalid.
}

enum Province {
  ALBERTA # Represents Alberta the province.
  BRITISH_COLUMBIA # Represents British Columbia the province.
  MANITOBA # Represents Manitoba the province.
  NEWFOUNDLAND_AND_LABRADOR # Represents Newfoundland And Labrador the province.
  NEW_BRUNSWICK # Represents New Brunswick the province.
  NORTHWEST_TERRITORIES # Represents Northwest Territories the province.
  NOVA_SCOTIA # Represents Nova Scotia the province.
  NUNAVUT # Represents Nunavut the province.
  ONTARIO # Represents Ontario the province.
  PRINCE_EDWARD_ISLAND # Represents Prince Edward Island the province.
  QUEBEC # Represents Quebec the province.
  SASKATCHEWAN # Represents Saskatchewan the province.
  YUKON # Represents Yukon the province.
}

enum ReferralIntentLevel {
  HIGH # Represents a high intent level for a referral.
  LOW # Represents a low intent level for a referral.
  MEDIUM # Represents a medium intent level for a referral.
}

enum ReferralStatus {
  CONVERTED # Given to referrals that have been converted to a matter.
  OPEN # Given to referrals that are currently open.
  RETIRED # Given to referrals that are no longer being pursued.
}

enum ReferralType {
  PURCHASE_PROPERTY_CLOSING # Represents a referral for a purchase property closing.
  REFINANCE # Represents a referral for a refinance.
  SALE_PROPERTY_CLOSING # Represents a referral for a sale property closing.
  STATUS_CERTIFICATE_REVIEW # Represents a referral for a status certificate review.
}

scalar Decimal # A signed decimal number, which supports arbitrary precision and is serialized as a string.
scalar FileRecordGID # A global identifier for a FileRecord object in format of 'gid://ownright/FileRecord/ID'.
scalar GID # A global identifier for an object in the format of 'gid://ownright/ObjectType/ID'.
scalar ISO8601DateTime # An ISO 8601-encoded datetime