# Line Items API - "One-time" Billing Frequency option invalid?

**URL:** <https://community.hubspot.com/t/line-items-api-one-time-billing-frequency-option-invalid/106458>\
**Category:** APIs & Integrations\
**Tags:** object\
**Created:** [May 3, 2024, 11:31pm UTC](https://community.hubspot.com/t/line-items-api-one-time-billing-frequency-option-invalid/106458 "2024-05-03T23:31:10Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![DCombs](https://avatars.discourse-cdn.com/v4/letter/d/51bf81/32.png) [@DCombs](https://community.hubspot.com/u/DCombs)\
**Post date:** [May 3, 2024, 11:31pm UTC](https://community.hubspot.com/t/line-items-api-one-time-billing-frequency-option-invalid/106458/1 "2024-05-03T23:31:10Z")

</div>

“One-time” is a Billing Frequency option for users when adding Line Items on the frontend:

 ![line items options - one_time.png](https://d2qpr2jzcazej7.cloudfront.net/original/2X/8/89afbcaefb03e6b5bd7641308efed20eb0a54594.png)

However, one-time does not show up in the Properties view for Line Items:

 ![DCombs_1-1714778948386.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/2/6/265b43516a6f55a3717a9319f96f6effed83f1e2.png)

I am trying to create line items on a deal using the Line Items API, but when I set Billing Frequency equal to “one\_time”, I’m getting an error message in the API response of:

Invalid value ‘one\_time’ for property ‘recurringbillingfrequency’"

Any ideas how to identify a Line Items billing frequency as “one\_time” using API?

---

<div class="post-metadata">

**Author:** ![Jaycee\_Lewis](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jaycee_lewis/32/61352_2.png) [@Jaycee\_Lewis](https://community.hubspot.com/u/Jaycee_Lewis)\
**Post date:** [May 6, 2024, 9:25pm UTC](https://community.hubspot.com/t/line-items-api-one-time-billing-frequency-option-invalid/106458/2 "2024-05-06T21:25:53Z")

</div>

Hey, @DCombs 👋 If we make a request to the [Properties API](https://developers.hubspot.com/docs/api/crm/properties) for the Line Items object and the internal value of `recurringbillingfrequency` we get the following detail back —

`description": "How often a line item with recurring billing is billed. It informs the pricing calculation for deals and quotes. Line items with one-time billing aren’t included."`

Example:

Request

```lia-code-sample
curl --request GET \
 --url 'https://api.hubapi.com/crm/v3/properties/line_items/recurringbillingfrequency?archived=false' \
 --header 'authorization: Bearer YOUR_ACCESS_TOKEN'

```

Response

```lia-code-sample
HTTP 200

{
 "updatedAt": "2023-10-24T19:45:52.858Z",
 "createdAt": "2019-08-06T02:42:39.570Z",
 "name": "recurringbillingfrequency",
 "label": "Billing frequency",
 "type": "enumeration",
 "fieldType": "select",
 "description": "How often a line item with recurring billing is billed. It informs the pricing calculation for deals and quotes. Line items with one-time billing aren’t included.",
 "groupName": "price",
 "options": [
 {
 "label": "Monthly",
 "value": "monthly",
 "description": "",
 "displayOrder": 0,
 "hidden": false
 },
 {
 "label": "Quarterly",
 "value": "quarterly",
 "description": "",
 "displayOrder": 1,
 "hidden": false
 },
 {
 "label": "Semi-annually",
 "value": "per_six_months",
 "description": "",
 "displayOrder": 2,
 "hidden": false
 },
 {
 "label": "Annually",
 "value": "annually",
 "description": "",
 "displayOrder": 3,
 "hidden": false
 },
 {
 "label": "Every two years",
 "value": "per_two_years",
 "description": "",
 "displayOrder": 4,
 "hidden": false
 },
 {
 "label": "Every three years",
 "value": "per_three_years",
 "description": "",
 "displayOrder": 5,
 "hidden": false
 },
 {
 "label": "Every four years",
 "value": "per_four_years",
 "displayOrder": 6,
 "hidden": false
 },
 {
 "label": "Every five years",
 "value": "per_five_years",
 "displayOrder": 7,
 "hidden": false
 }
 ],
 "displayOrder": -1,
 "calculated": false,
 "externalOptions": false,
 "hasUniqueValue": false,
 "hidden": false,
 "hubspotDefined": true,
 "showCurrencySymbol": false,
 "modificationMetadata": {
 "archivable": true,
 "readOnlyDefinition": true,
 "readOnlyValue": false
 },
 "formField": false,
 "dataSensitivity": "non_sensitive"
}

```

Question — Can you create a line item and associate it to a deal without including the property —`recurringbillingfrequency`?

Thanks for the additional details! — Jaycee

---

<div class="post-metadata">

**Author:** ![DCombs](https://avatars.discourse-cdn.com/v4/letter/d/51bf81/32.png) [@DCombs](https://community.hubspot.com/u/DCombs)\
**Post date:** [May 11, 2024, 8:22pm UTC](https://community.hubspot.com/t/line-items-api-one-time-billing-frequency-option-invalid/106458/3 "2024-05-11T20:22:27Z")

</div>

Thank you for this detailed feedback [@Jaycee\_Lewis](https://community.hubspot.com/t5/user/viewprofilepage/user-id/127074)!

I found that if I left the recurringbillingfrequency as blank in the API export, the Line Item defaulted to “One-time” in HubSpot. Not the exact behavior I would have expected, but it makes sense now and is working. Thanks again!

---

<div class="post-metadata">

**Author:** ![Jaycee\_Lewis](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jaycee_lewis/32/61352_2.png) [@Jaycee\_Lewis](https://community.hubspot.com/u/Jaycee_Lewis)\
**Post date:** [May 14, 2024, 7:47pm UTC](https://community.hubspot.com/t/line-items-api-one-time-billing-frequency-option-invalid/106458/4 "2024-05-14T19:47:22Z")

</div>

Thank you so much @DCombs for taking the time to loop back and let us know what worked! — Jaycee