# Create GroupDivision Creates a new GroupDivision Endpoint: POST /groups/{groupID}/divisions Version: v1 Security: apiKeyAuth, bearerAuth ## Header parameters: - `vbasoftware-database` (string, required) Target database ## Path parameters: - `groupID` (string, required) Group ID ## Request fields (application/json): - `group_ID` (string, required) References Groups.Group_ID value on parent record. - `division_ID` (string, required) Unique Division identifier assigned inside this Group. This ID must be unique within the Group ID. - `acH_Account_Key` (integer,null) References the FundingAccount.Account_Key that holds the ACH information for this Division for any ACH processing. - `account_Key` (integer,null) References the PayorAccount.Account_Key value in parent table. - `address` (string,null) Address associated with the Division. - `address2` (string,null) Address 2 associated with the Division. - `adult_Age` (integer,null) Identifies the age at which dependents are considered to be adults. Student status information is required on the enrollment to allow claims to pay for a dependent whose age exceeds the age defined here. - `agri_Tax_Return` (string,null) Information field for custom client reporting. - `auth_Not_Reqd_Override` (boolean, required) This flag tells adjudication to not error if no authorization is found on claims that require authorization. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `brokerage` (string,null) Information field for custom client reporting. - `cobrA_Auto_Term_Adj_Reason` (integer,null) When utilizing the Auto-Term process, notes the adjustment reason applied to premiums impacted by a retro term. - `cobrA_Auto_Term_Reason` (integer,null) When utilizing the Auto-Term process, indicates the Term Reason to apply if COBRA is being enrolled. - `cobrA_Division` (boolean, required) Points to the Division ID that is the COBRA Division for this Division. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `coE_Network` (boolean, required) Information field for custom client reporting. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `caseRate` (number,null) Information field for custom client reporting. - `city` (string,null) City of the Division address. - `claim_Days_Allowed` (integer,null) No longer in use. - `class_Description` (string,null) No longer in use, replaced by GroupClass table. - `class_ID` (string,null) No longer in use, replaced by GroupClass table. - `contact_Country_Code` (string,null) Country Code for the Contact Phone Number. - `contact_Email_Address` (string,null) The division contact email address. - `contact_Extension` (string,null) The contacts extension for their phone number. - `contact_Phone` (string,null) The Contact Phone number for this Divisions Contact. - `contact_Title` (string,null) Title of the Division's primary contact. - `country_ID` (string,null) Country ID associated with the Division. - `county_Code` (string,null) County code of the Division address. - `cutoff_Age` (integer,null) Identifies the age at which dependents are no longer eligible for coverage. Adult Dependent information is required on the enrollment to allow claims to pay for a dependent whose age exceeds the age defined here. - `default_COBRA_Reason` (integer,null) When disenrolling a member and reenrolling into COBRA, this indicates the default reason attached to the disenroll. - `default_Invoice_ReportDefinition_Key` (integer,null) For reports in the "INV" Report_Category, this provides the user with the list of invoice reports they can set as the default report using for automated invoice generation. - `disability_Pay_Through_Day` (integer,null) Indicates the day of the week the paid through is set when using automatic paid through dates. - `disenroll_Date` (string,null) This notes that the Division has been terminated and what date. An active Division has a NULL value here. - `distribution_Account_Key` (integer,null) References the PayorAccount.Account_Key value in parent table. - `distribution_Payor_ID` (string,null) References the PayorAccount.Payor_ID value in parent table. - `duplicate_Claim_Override` (boolean, required) This flag tells adjudication to ignore Duplicate Claims Processing logic if enabled. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `entry_Date` (string) Date when the record was first added to the system. - `entry_User` (string,null) User that first added the record to the system. - `exempt_Federal` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking Federal taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `exempt_Medicare` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking Medicare taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `exempt_SocSec` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking Social Security taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `exempt_State` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking State taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `ficA_Employer_Match` (boolean, required) Notes if the employer matches FICA (lowers that tax to 0) during claims adjudication. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `fax` (string,null) The fax number for this Division. - `fax_Country_Code` (string,null) Country Code for the Division Fax Number. - `federal_ID` (string,null) This Division Tax ID. - `federal_Tax_Day_Limit` (integer,null) Limit of days for the federal tax exemption. - `federal_Wage_Limit` (number,null) Wage limit for the federal tax exemption. - `generate_W2` (boolean, required) Notes if this Division is part of tax reporting and should have its data sent for W2 generation. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `groupDivisionCaptive` (string,null) Information field for custom client reporting. - `invoice_Grace_Period` (integer,null) Indicates the grace period for invoice generation for this Division. This value works with "Invoice_Grace_Period_Type" to determine duration. - `invoice_Grace_Period_Ex_Code` (string,null) When a grace period is applied to an invoice that impacts "Paid Through", the affected claims will apply this Ex Code. - `invoice_Grace_Period_Type` (string,null) Based on "Invoice_Grace_Period", this is the Days, Weeks, Months or Years that grace period extends. - `invoice_Level` (string,null) Indiciates the level of invoicing done by premium billing. There are 3 levels you can configure: S - Subscriber level invoicing (meaning an invoice per enrolled Subscriber), D - Division level invoicing (meaning an invoice per Division with all enrolled Subscribers in that Division on that Invoice), and G - Group level invoicing (meaning an invoice for the whole group with all enrolled Subscribers on the same invoice). - `invoice_Remit_Address1` (string,null) When generating Division level invoices through premium biling, this is the Address on that invoice. - `invoice_Remit_Address2` (string,null) When generating Division level invoices through premium biling, this is the Address 2 on that invoice. - `invoice_Remit_City` (string,null) When generating Division level invoices through premium biling, this is the City on that invoice. - `invoice_Remit_Country_Code` (string,null) When generating Division level invoices through premium biling, this is the Phone Number Country Code on that invoice. - `invoice_Remit_Country_ID` (string,null) When generating Division level invoices through premium biling, this is the Country ID on that invoice. - `invoice_Remit_Name` (string,null) When generating Division level invoices through premium biling, this is the Name on that invoice. - `invoice_Remit_Phone_Number` (string,null) When generating Division level invoices through premium biling, this is the Phone Number on that invoice. - `invoice_Remit_State` (string,null) When generating Division level invoices through premium biling, this is the State on that invoice. - `invoice_Remit_Zip_Code` (string,null) When generating Division level invoices through premium biling, this is the Zip Code on that invoice. - `issue_State` (string,null) For Life & Disability clients, this holds the issue state for processing taxes and reporting. - `mail_To_Default` (boolean, required) For Life & Disability clients, this is the default Mail To setting applied to claims created through the advisor wizards. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `medicare_Tax_Day_Limit` (integer,null) Limit of days for the medicare tax exemption. - `medicare_Wage_Limit` (number,null) Wage liimit for the medicare tax exemption. - `name` (string,null) Name of the Group Division. - `notes` (string,null) No longer in use. Replaced by the Notes module. - `numberLives` (integer,null) Information field for custom client reporting. - `original_Date` (string,null) This is the first start date (original effective date) of the Division inside this group. This date should be equal to or earlier than the first GroupContact.Coverage_Start date attached to this Division. - `other_Insurance_ExCode` (string,null) This is the Ex Code applied if COB is identified during adjudciation and Other Insurance information is used during processing. - `paid_Through` (string,null) This is the paid through date for any Division level invoices through premium billing. This can be manually set or updated by the system. - `participationIncentive_ID` (string,null) Information field for custom client reporting. - `pay_To_Account` (integer,null) For processing that uses the Pay To Account, this referneces the FundingAccount.Account_Key for that process. - `payor_ID` (string,null) References the PayorAccount.Payor_ID value in parent table. - `pend_Ex_Code` (string,null) The Ex Code applied during claims adjudication if "Pend_Flag" is enabled. - `pend_Flag` (string,null) Notes that this Division should have a pend code (Ex Code) applied during claims processing for any claims for this Division. - `phone` (string,null) The phone number for this Division. - `phone_Country_Code` (string,null) Country Code for the Division Phone Number. - `premium_Location` (string,null) No longer in use. - `primary_Contact` (string,null) Primary contact of the Division. - `prorate_Deduction` (boolean, required) Notes if this division should have disability deductions pro-rated during claims processing. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `prorate_Deduction_Type` (string,null) Indicates the type of prorating to calculate against. If calculating against flat deduction types only, set to F, to apply prorating to Percentage based deductions, set to P, if applying prorating on all deduction types, set to B. - `reference_Based_Pricing` (string,null) Information field for custom client reporting. - `region_Code` (string,null) Information field for noting the region for this Division. - `reinsurance_Option` (string,null) No longer in use. Replaces by the full reinsurance module. - `seerData` (integer,null) Information field for custom client reporting. - `set_Paid_Through` (boolean, required) Notes if this division should have the paid through set as part of satisfying a premium bill. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `socSec_Tax_Day_Limit` (integer,null) Limit of days for the social security tax exemption. - `socSec_Wage_Limit` (number,null) Wage limite for Social Security tax exemption. - `spec_Deductible` (string,null) No longer in use. Replaces by the full reinsurance module. - `state` (string,null) State of the Division address. - `state_Tax_Day_Limit` (integer,null) Limit of days for the state tax exemption. - `state_Wage_Limit` (number,null) Wage limit for the state tax exemption. - `tax_Day_Limit_Type` (integer, required) Indicates if the tax day limitations are by day or calendar months. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `transplantElite` (string,null) Information field for custom client reporting. - `update_Date` (string) Date when the record was last updated in the system. - `update_User` (string,null) User that last updated the record in the system. - `use_Restricted_Deductions` (boolean, required) Limits the deduction types that can be selected on disability claims to use the GroupDivisionDeductionType list. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `zip_Code` (string,null) The Zip Code for this Division address. ## Response 200 fields (text/plain): - `data` (object) - `data.group_ID` (string, required) References Groups.Group_ID value on parent record. - `data.division_ID` (string, required) Unique Division identifier assigned inside this Group. This ID must be unique within the Group ID. - `data.acH_Account_Key` (integer,null) References the FundingAccount.Account_Key that holds the ACH information for this Division for any ACH processing. - `data.account_Key` (integer,null) References the PayorAccount.Account_Key value in parent table. - `data.address` (string,null) Address associated with the Division. - `data.address2` (string,null) Address 2 associated with the Division. - `data.adult_Age` (integer,null) Identifies the age at which dependents are considered to be adults. Student status information is required on the enrollment to allow claims to pay for a dependent whose age exceeds the age defined here. - `data.agri_Tax_Return` (string,null) Information field for custom client reporting. - `data.auth_Not_Reqd_Override` (boolean, required) This flag tells adjudication to not error if no authorization is found on claims that require authorization. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.brokerage` (string,null) Information field for custom client reporting. - `data.cobrA_Auto_Term_Adj_Reason` (integer,null) When utilizing the Auto-Term process, notes the adjustment reason applied to premiums impacted by a retro term. - `data.cobrA_Auto_Term_Reason` (integer,null) When utilizing the Auto-Term process, indicates the Term Reason to apply if COBRA is being enrolled. - `data.cobrA_Division` (boolean, required) Points to the Division ID that is the COBRA Division for this Division. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.coE_Network` (boolean, required) Information field for custom client reporting. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.caseRate` (number,null) Information field for custom client reporting. - `data.city` (string,null) City of the Division address. - `data.claim_Days_Allowed` (integer,null) No longer in use. - `data.class_Description` (string,null) No longer in use, replaced by GroupClass table. - `data.class_ID` (string,null) No longer in use, replaced by GroupClass table. - `data.contact_Country_Code` (string,null) Country Code for the Contact Phone Number. - `data.contact_Email_Address` (string,null) The division contact email address. - `data.contact_Extension` (string,null) The contacts extension for their phone number. - `data.contact_Phone` (string,null) The Contact Phone number for this Divisions Contact. - `data.contact_Title` (string,null) Title of the Division's primary contact. - `data.country_ID` (string,null) Country ID associated with the Division. - `data.county_Code` (string,null) County code of the Division address. - `data.cutoff_Age` (integer,null) Identifies the age at which dependents are no longer eligible for coverage. Adult Dependent information is required on the enrollment to allow claims to pay for a dependent whose age exceeds the age defined here. - `data.default_COBRA_Reason` (integer,null) When disenrolling a member and reenrolling into COBRA, this indicates the default reason attached to the disenroll. - `data.default_Invoice_ReportDefinition_Key` (integer,null) For reports in the "INV" Report_Category, this provides the user with the list of invoice reports they can set as the default report using for automated invoice generation. - `data.disability_Pay_Through_Day` (integer,null) Indicates the day of the week the paid through is set when using automatic paid through dates. - `data.disenroll_Date` (string,null) This notes that the Division has been terminated and what date. An active Division has a NULL value here. - `data.distribution_Account_Key` (integer,null) References the PayorAccount.Account_Key value in parent table. - `data.distribution_Payor_ID` (string,null) References the PayorAccount.Payor_ID value in parent table. - `data.duplicate_Claim_Override` (boolean, required) This flag tells adjudication to ignore Duplicate Claims Processing logic if enabled. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.entry_Date` (string) Date when the record was first added to the system. - `data.entry_User` (string,null) User that first added the record to the system. - `data.exempt_Federal` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking Federal taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.exempt_Medicare` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking Medicare taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.exempt_SocSec` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking Social Security taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.exempt_State` (boolean, required) For Disability tax calculations, this indicates if the Division is exempt from taking State taxes on the claim payments. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.ficA_Employer_Match` (boolean, required) Notes if the employer matches FICA (lowers that tax to 0) during claims adjudication. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.fax` (string,null) The fax number for this Division. - `data.fax_Country_Code` (string,null) Country Code for the Division Fax Number. - `data.federal_ID` (string,null) This Division Tax ID. - `data.federal_Tax_Day_Limit` (integer,null) Limit of days for the federal tax exemption. - `data.federal_Wage_Limit` (number,null) Wage limit for the federal tax exemption. - `data.generate_W2` (boolean, required) Notes if this Division is part of tax reporting and should have its data sent for W2 generation. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.groupDivisionCaptive` (string,null) Information field for custom client reporting. - `data.invoice_Grace_Period` (integer,null) Indicates the grace period for invoice generation for this Division. This value works with "Invoice_Grace_Period_Type" to determine duration. - `data.invoice_Grace_Period_Ex_Code` (string,null) When a grace period is applied to an invoice that impacts "Paid Through", the affected claims will apply this Ex Code. - `data.invoice_Grace_Period_Type` (string,null) Based on "Invoice_Grace_Period", this is the Days, Weeks, Months or Years that grace period extends. - `data.invoice_Level` (string,null) Indiciates the level of invoicing done by premium billing. There are 3 levels you can configure: S - Subscriber level invoicing (meaning an invoice per enrolled Subscriber), D - Division level invoicing (meaning an invoice per Division with all enrolled Subscribers in that Division on that Invoice), and G - Group level invoicing (meaning an invoice for the whole group with all enrolled Subscribers on the same invoice). - `data.invoice_Remit_Address1` (string,null) When generating Division level invoices through premium biling, this is the Address on that invoice. - `data.invoice_Remit_Address2` (string,null) When generating Division level invoices through premium biling, this is the Address 2 on that invoice. - `data.invoice_Remit_City` (string,null) When generating Division level invoices through premium biling, this is the City on that invoice. - `data.invoice_Remit_Country_Code` (string,null) When generating Division level invoices through premium biling, this is the Phone Number Country Code on that invoice. - `data.invoice_Remit_Country_ID` (string,null) When generating Division level invoices through premium biling, this is the Country ID on that invoice. - `data.invoice_Remit_Name` (string,null) When generating Division level invoices through premium biling, this is the Name on that invoice. - `data.invoice_Remit_Phone_Number` (string,null) When generating Division level invoices through premium biling, this is the Phone Number on that invoice. - `data.invoice_Remit_State` (string,null) When generating Division level invoices through premium biling, this is the State on that invoice. - `data.invoice_Remit_Zip_Code` (string,null) When generating Division level invoices through premium biling, this is the Zip Code on that invoice. - `data.issue_State` (string,null) For Life & Disability clients, this holds the issue state for processing taxes and reporting. - `data.mail_To_Default` (boolean, required) For Life & Disability clients, this is the default Mail To setting applied to claims created through the advisor wizards. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.medicare_Tax_Day_Limit` (integer,null) Limit of days for the medicare tax exemption. - `data.medicare_Wage_Limit` (number,null) Wage liimit for the medicare tax exemption. - `data.name` (string,null) Name of the Group Division. - `data.notes` (string,null) No longer in use. Replaced by the Notes module. - `data.numberLives` (integer,null) Information field for custom client reporting. - `data.original_Date` (string,null) This is the first start date (original effective date) of the Division inside this group. This date should be equal to or earlier than the first GroupContact.Coverage_Start date attached to this Division. - `data.other_Insurance_ExCode` (string,null) This is the Ex Code applied if COB is identified during adjudciation and Other Insurance information is used during processing. - `data.paid_Through` (string,null) This is the paid through date for any Division level invoices through premium billing. This can be manually set or updated by the system. - `data.participationIncentive_ID` (string,null) Information field for custom client reporting. - `data.pay_To_Account` (integer,null) For processing that uses the Pay To Account, this referneces the FundingAccount.Account_Key for that process. - `data.payor_ID` (string,null) References the PayorAccount.Payor_ID value in parent table. - `data.pend_Ex_Code` (string,null) The Ex Code applied during claims adjudication if "Pend_Flag" is enabled. - `data.pend_Flag` (string,null) Notes that this Division should have a pend code (Ex Code) applied during claims processing for any claims for this Division. - `data.phone` (string,null) The phone number for this Division. - `data.phone_Country_Code` (string,null) Country Code for the Division Phone Number. - `data.premium_Location` (string,null) No longer in use. - `data.primary_Contact` (string,null) Primary contact of the Division. - `data.prorate_Deduction` (boolean, required) Notes if this division should have disability deductions pro-rated during claims processing. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.prorate_Deduction_Type` (string,null) Indicates the type of prorating to calculate against. If calculating against flat deduction types only, set to F, to apply prorating to Percentage based deductions, set to P, if applying prorating on all deduction types, set to B. - `data.reference_Based_Pricing` (string,null) Information field for custom client reporting. - `data.region_Code` (string,null) Information field for noting the region for this Division. - `data.reinsurance_Option` (string,null) No longer in use. Replaces by the full reinsurance module. - `data.seerData` (integer,null) Information field for custom client reporting. - `data.set_Paid_Through` (boolean, required) Notes if this division should have the paid through set as part of satisfying a premium bill. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.socSec_Tax_Day_Limit` (integer,null) Limit of days for the social security tax exemption. - `data.socSec_Wage_Limit` (number,null) Wage limite for Social Security tax exemption. - `data.spec_Deductible` (string,null) No longer in use. Replaces by the full reinsurance module. - `data.state` (string,null) State of the Division address. - `data.state_Tax_Day_Limit` (integer,null) Limit of days for the state tax exemption. - `data.state_Wage_Limit` (number,null) Wage limit for the state tax exemption. - `data.tax_Day_Limit_Type` (integer, required) Indicates if the tax day limitations are by day or calendar months. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.transplantElite` (string,null) Information field for custom client reporting. - `data.update_Date` (string) Date when the record was last updated in the system. - `data.update_User` (string,null) User that last updated the record in the system. - `data.use_Restricted_Deductions` (boolean, required) Limits the deduction types that can be selected on disability claims to use the GroupDivisionDeductionType list. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.zip_Code` (string,null) The Zip Code for this Division address. - `error` (object) - `error.detail` (string,null) A human-readable explanation specific to this occurrence of the problem. - `error.instance` (string,null) A URI reference that identifies the specific occurrence of the problem.It may or may not yield further information if dereferenced. - `error.status` (integer) The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem. - `error.title` (string,null) A short, human-readable summary of the problem type.It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization(e.g., using proactive content negotiation; see[RFC7231], Section 3.4). - `error.type` (string,null) A URI reference [RFC3986] that identifies the problem type. This specification encourages that, when dereferenced, it provide human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank". - `debug` (object) - `debug.activityID` (string, required) ## Response 401 fields