Creating an Account

Creating Nav user accounts is done through GraphQL mutations. See Using our GraphQL API and createAccount GraphQL Mutation.

Required arguments:

• userID
• email
• businessName
• businessState
• businessZip

Existing Business Information

If you already have the user’s DUNS, Experian BIN, or Equifax ID numbers you can also provide them explicitly with duns, experianBIN, or equifaxID arguments to createAccount. If you omit them, Nav will automatically search businesses for the closest matching name and address and auto-fill these fields. The example below demonstrates omitting these arguments from the request, but specifying that the auto-filled values should be returned in the response.

Example

mutation CreateNavAccount(
  $userID: String!
  $email: String
  $businessName: String!
  $businessAddress: String
  $businessCity: String
  $businessState: String!
  $businessZip: String!
  $businessPhone: String
) {
  createAccount(
    userID: $userID
    email: $email
    businessName: $businessName
    businessAddress: $businessAddress
    businessCity: $businessCity
    businessState: $businessState
    businessZip: $businessZip
    businessPhone: $businessPhone
  ) {
    userID
    email
    businesses {
      name
      duns
      experianBIN
      equifaxID
    }
  }
}

Variables:

{
  "userID": "user_q4ni4f8a",
  "email": "some_user@example.com",
  "businessName": "Casa Blanca Catering",
  "businessAddress": "1600 Pennsylvania Avenue",
  "businessCity": "Washington",
  "businessState": "DC",
  "businessZip": "20500",
  "businessPhone": "2024561111"
}

Example Response:

{
  "data": {
    "createAccount": {
      "userID": "user_q4ni4f8a",
      "email": "some_user@example.com",
      "businesses": [
        {
          "name": "Casa Blanca Catering",
          "duns": "046116423",
          "experianBIN": "772645288",
          "equifaxID": "570558777"
        }
      ]
    }
  }
}