---
title: "Delete a custom field definition"
method: DELETE
path: "/customFieldDefinition/{id}"
tags: ["Custom Field"]
---

# Delete a custom field definition

`DELETE /customFieldDefinition/{id}`

## Request

- Base URL: `https://api.app.subskribe.com`
- URL: `https://api.app.subskribe.com/customFieldDefinition/{id}`
- Auth: API key in header `X-API-Key`

Deletes an existing custom field definition for your tenant. On success the deleted custom field definition object is returned.

## Path parameters

- `id` string, required

## Response `200`

successful operation

- CustomFieldDefinitionJson
  - `id` string
  - `parentObjectType` 'ACCOUNT' | 'ORDER' | 'ORDER_ITEM' | 'PLAN' | 'CHARGE' | 'INVOICE' | 'SALES_ROOM' | 'SUBSCRIPTION' | 'SUBSCRIPTION_ITEM' | 'OPPORTUNITY'
  - `fieldType` 'STRING' | 'PICKLIST' | 'MULTISELECT_PICKLIST'
  - `fieldName` string
  - `fieldLabel` string
  - `options` string[]
  - `required` boolean
  - `createdOn` integer
  - `updatedOn` integer
  - `defaultValue` CustomFieldDefault
    - `value` string
    - `selections` string[]

---

[API](https://skmtc.dev/dealhub/apis/subskribe-api.md) - [All operations](https://skmtc.dev/dealhub/apis/subskribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/subskribe-api/revisions/c1ee531b82ce?raw)