Create application

mutation CreateUnderwritingApplication($input: UnderwritingApplicationCreateInput!) {
  createUnderwritingApplication(input: $input) {
    underwritingApplication {
      id
      applicationStatus
      createdDateTime
    }
    errors {
      ... on UnderwritingApplicationValidationError {
        message
        code
      }
    }
  }
}

{
  "input": {
    "underwritingIdentity": {
      "legalEntityName": "Example Corp",
      "businessName": "Example",
      "serviceTelephoneNumber": "5555551234"
    },
    "stakeholders": [
      {
        "addPersonStakeholderInput": {
          "roles": ["OWNER"],
          "name": {
            "firstName": "Jane",
            "lastName": "Smith"
          },
          "birthDate": "1985-06-15",
          "identificationNumber": {
            "type": "SSN",
            "value": "123456789"
          },
          "ownershipPercentage": "1.00"
        }
      }
    ]
  }
}

{
  "data": {
    "createUnderwritingApplication": {
      "underwritingApplication": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "applicationStatus": "CREATED",
        "createdDateTime": "2024-01-15T10:30:00Z"
      },
      "errors": []
    }
  }
}

The first step in the underwriting process is creating an application. This establishes a new record in the Tesouro platform, allowing you to progressively add business, stakeholder, and financial details before submission.

Create application mutation

Use the createUnderwritingApplication mutation to create a new underwriting application.

ScenarioBen creates an underwriting application for his mechanical keyboard business. He provides his business information and his own details as the owner initially, planning to add bank account details after he finalizes which account to use.

mutation CreateUnderwritingApplication($input: UnderwritingApplicationCreateInput!) {
  createUnderwritingApplication(input: $input) {
    underwritingApplication {
      id
      applicationStatus
      createdDateTime
    }
    errors {
      ... on UnderwritingApplicationValidationError {
        message
        code
      }
    }
  }
}

{
  "input": {
    "underwritingIdentity": {
      "legalEntityName": "Example Corp",
      "businessName": "Example",
      "serviceTelephoneNumber": "5555551234"
    },
    "stakeholders": [
      {
        "addPersonStakeholderInput": {
          "roles": ["OWNER"],
          "name": {
            "firstName": "Jane",
            "lastName": "Smith"
          },
          "birthDate": "1985-06-15",
          "identificationNumber": {
            "type": "SSN",
            "value": "123456789"
          },
          "ownershipPercentage": "1.00"
        }
      }
    ]
  }
}

{
  "data": {
    "createUnderwritingApplication": {
      "underwritingApplication": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "applicationStatus": "CREATED",
        "createdDateTime": "2024-01-15T10:30:00Z"
      },
      "errors": []
    }
  }
}

Client credentials Update application

⌘I

Getting started

Authentication

Applications

Stakeholders

Decision components

Information requests

Webhooks

Create application

Create application mutation

​Create application mutation

Create application mutation