# Create or Update Batch Subscribers

Create or Update multiple Subscribers at once.  If the entity exists, it will be updated.  If the entity does not exist, it will be created.

Endpoint: PUT /subscribers-batch
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

  - `vbasoftware-database` (string, required)
    Target database

## Request fields (application/json):

  - `subscriber_ID` (string,null)
    Unique identifier for each family unit inside VBA. This value can be imported, assigned or randomly assigned by the system at time of record creation.

  - `address` (string,null)
    Address of the Subscriber.

  - `address2` (string,null)
    Address Line 2 of the Subscriber.

  - `billing_Cycle_ID` (string,null)
    Assigns a default billing cycle to be used when the Group Division 'Inv. Level' is set to 'Subscriber'.

  - `billing_Invoice_Create` (integer,null)
    Specifies the number of projected billing cycles to include per invoice generation.

  - `city` (string,null)
    City of the Subscriber.

  - `country_ID` (string,null)
    Country of the Subscriber.

  - `county_Code` (string,null)
    County of the Subscriber.

  - `date_Enrolled` (string,null)
    Date when the Subscriber was first enrolled.

  - `disenroll_Date` (string,null)
    Date when the Subscriber was disenrolled.

  - `email` (string,null)
    Email of the Subscriber.

  - `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.

  - `first_Name` (string,null)
    First name of the Subscriber.

  - `home_Country_Code` (string,null)
    Country Code for the home phone number of the Subscriber.

  - `home_Phone` (string,null)
    Home phone number of the Subscriber.

  - `issue_State` (string,null)
    For Life & Disability clients, this holds the issue state for processing taxes and reporting.

  - `last_Name` (string,null)
    Last name of the Subscriber.

  - `middle_Name` (string,null)
    Middle initial of the Subscriber.

  - `name_Suffix` (string,null)
    Suffix or title associated with the Subscriber.

  - `notes` (string,null)
    No longer in use. Replaced by NotData, NoteSource and NoteReference tables.

  - `other_Name` (string,null)
    Information only. Used for custom reporting or client integrations.

  - `pay_Period` (string,null)
    Number of annual pay periods for the Subscriber. This field is informational only.

  - `pay_To_Account` (integer,null)
    References the FundingAccount.Account_Key and indicates the account to pay when payment reference this subscriber.

  - `pend_Ex_Code` (string,null)
    Assigns an Ex Code that can be applied to newly adjudicated Subscriber claims.

  - `pend_Flag` (string,null)
    While active, assigned Ex Codes will be applied to any newly adjudicated Subscriber claims.

  - `region_Code` (string,null)
    Region code of the Member's primary address.

  - `salutation` (string,null)
    Used by CSR to indicate the proper salutation used when communicating with the Insured.

  - `sponsor_ID` (string,null)
    This holds the Subscriber ID of the subscriber that sponsored this subscriber.

  - `sponsor_Relate_Code` (string,null)
    This identifies the relationship between the sponor and this subscriber.

  - `state` (string,null)
    State of the Subscriber.

  - `status` (string,null)
    No longer in use.

  - `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.

  - `work_Country_Code` (string,null)
    Country Code for the work phone number of the Subscriber.

  - `work_Phone` (string,null)
    Work phone number of the Subscriber.

  - `zip_Code` (string,null)
    Zip Code of the Subscriber.

## Response 207 fields (text/plain):

  - `data` (array,null)

  - `data.id` (array, required)
    List of key/value pairs that represent the unique id for the entity operation.

  - `data.id.key` (string,null)

  - `data.id.value` (any,null)

  - `data.status` (integer, required)
    http status of the operation (eg, 200, 201, 500)

  - `data.body` (string, required)
    operation message (eg, Updated, Created, Error message)

  - `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