# startWorkflow

**Type:** GraphQL mutations

**Description:**
Start a workflow utilizing one or more Visibly services

## Arguments
- name (String): The name of the workflow to run
- patient (PatientInput): Optional patient information
  - patientId (String): Patient ID
  - firstName (String): First name
  - middleName (String): Middle name
  - lastName (String): Last name
  - dateOfBirth (String): Date of birth in ISO 8601 format, i.e., YYYY-MM-DD
  - phoneNumber (String): Phone number
  - email (String): Email address
  - address (String): Street address #1
  - address2 (String): Street address #2
  - city (String): City
  - state (String): State
  - zipCode (String): Zip code
  - schedulerLink (String): Scheduler link
- doctorId (String): Optional doctor Id
- doctor (DoctorInput): Optional doctor information
  - doctorId (String): Doctor ID (conditionally required if doctor name, practice name, and phone number are not set)
  - doctorName (String): Doctor name (conditionally required if doctor ID is not set)
  - practiceName (String): Practice name (conditionally required if doctor ID is not set)
  - phoneNumber (String): Phone number (conditionally required if doctor ID is not set)
  - faxNumber (String): Fax number
  - email (String): Doctor email address
  - address (String): Street address #1
  - address2 (String): Street address #2
  - city (String): City
  - state (String): State
  - zipCode (String): Zip code
  - url (String): Website URL
- products (ContactProductInput): Optional ordered products
  - productId (String): ID that uniquely maps to a manufacturer, brand, and model combination
  - eye (Eye, Not Null): Indication of left (OS) or right (OD) eye

  - sphere (String): The amount of lens power measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
  - diameter (String): The width of the contact lens from edge to edge measured by millimeters
  - baseCurve (String): Indication of the curvature of the inside of the lens
  - axis (String): The lens meridian with no cylinder power, indicated by a value between 1 and 180 degrees
  - cylinder (String): The amount of lens power for astigmatism measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
  - addition (String): The additional magnifying power that applies to the bottom portion of multifocal lenses to fix presbyopia
  - dominance (String): Indication of dominant or non-dominant eye
  - color (String): Color of the lens
  - packageSize (Int): Number of lenses per package
  - quantity (Int): Number of packages
- prescriptions (ContactProductInput): Prescriptions pertinent to the ordered products
  - productId (String): ID that uniquely maps to a manufacturer, brand, and model combination
  - eye (Eye, Not Null): Indication of left (OS) or right (OD) eye

  - sphere (String): The amount of lens power measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
  - diameter (String): The width of the contact lens from edge to edge measured by millimeters
  - baseCurve (String): Indication of the curvature of the inside of the lens
  - axis (String): The lens meridian with no cylinder power, indicated by a value between 1 and 180 degrees
  - cylinder (String): The amount of lens power for astigmatism measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
  - addition (String): The additional magnifying power that applies to the bottom portion of multifocal lenses to fix presbyopia
  - dominance (String): Indication of dominant or non-dominant eye
  - color (String): Color of the lens
  - packageSize (Int): Number of lenses per package
  - quantity (Int): Number of packages
- fileIds (String): File IDs from *uploadFile* for flat files containing prescription information
- tags (TagInput): List of tags used to correlate this workflow with other systems
  - name (String): The name of the tag
  - value (String): The value of the tag

## Response
**Type:** Workflow
**Description:**
Start Workflow Request information

### Fields
- workflowId (String): Unique ID for this workflow
- launchUrl (String): If applicable, the launch URL for the first step in this workflow
- requestId (String): Unique ID for a prescription verification request if applicable
- requestStatus (ContactPrescriptionVerificationRequestStatus): Current request status
- jobId (String): Unique ID for a prescription verification job (conditionally available)
- status (String): Current prescription verification job status (conditionally available)
- updatedAt (String): Last date and time this request was updated