# Create ProviderWithhold

Creates a new ProviderWithhold

Endpoint: POST /provider-withholds
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

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

## Request fields (application/json):

  - `providerWithhold_Key` (integer, required)
    Unique identifier for each Withhold setting.

  - `account_Key` (integer,null)
    This field indicates the funding account criteria by which the withhold is applied to a claim.

  - `benefit_Code` (string,null)
    Benefit code required for adjudication matching.

  - `effective_Date` (string, required)
    Start of the range of acceptable service dates for the admin fee.

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

  - `ex_Code` (string,null)
    Ex code associated with the price line.

  - `federal_ID` (string,null)
    Allows setting the Tax ID that this withhold will apply when applying a withhold across multiple Providers.

  - `network_ID` (string,null)
    Identifies the required Network for adjudication matching.

  - `payor_ID` (string,null)
    This field indicates the payor criteria by which the withhold is applied to a claim.

  - `provider_ID` (string,null)
    The Provider ID this Withhold setting is being applied.

  - `term_Date` (string,null)
    End of the range of acceptable service dates for the admin fee.

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

  - `withhold` (number,null)
    Shows the withheld percentage.

  - `withhold_Max` (number,null)
    Indicates the max Withhold that can be taken for this withhold configuration.

  - `withhold_Pct` (boolean, required)
    Indicates if the Withhold value on this table is a Percentage or a Flat amount.

## Response 200 fields (text/plain):

  - `data` (object)

  - `data.providerWithhold_Key` (integer, required)
    Unique identifier for each Withhold setting.

  - `data.account_Key` (integer,null)
    This field indicates the funding account criteria by which the withhold is applied to a claim.

  - `data.benefit_Code` (string,null)
    Benefit code required for adjudication matching.

  - `data.effective_Date` (string, required)
    Start of the range of acceptable service dates for the admin fee.

  - `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.ex_Code` (string,null)
    Ex code associated with the price line.

  - `data.federal_ID` (string,null)
    Allows setting the Tax ID that this withhold will apply when applying a withhold across multiple Providers.

  - `data.network_ID` (string,null)
    Identifies the required Network for adjudication matching.

  - `data.payor_ID` (string,null)
    This field indicates the payor criteria by which the withhold is applied to a claim.

  - `data.provider_ID` (string,null)
    The Provider ID this Withhold setting is being applied.

  - `data.term_Date` (string,null)
    End of the range of acceptable service dates for the admin fee.

  - `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.withhold` (number,null)
    Shows the withheld percentage.

  - `data.withhold_Max` (number,null)
    Indicates the max Withhold that can be taken for this withhold configuration.

  - `data.withhold_Pct` (boolean, required)
    Indicates if the Withhold value on this table is a Percentage or a Flat amount.

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