# Delete Custom Field

Permanently deletes an account-owned custom field and all contacts’ values in it. Global fields and fields still used by forms, automations or other entities are refused, naming them; remaining placeholders render empty. Only delete a field the user explicitly asked to delete.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "customFieldId": {
      "type": "string",
      "description": "ID of the field to delete",
      "minLength": 1,
      "maxLength": 100,
      "pattern": "^[A-Za-z0-9_]+$"
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account the access token works in",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "customFieldId"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "customFieldId",
    "name",
    "deleted",
    "placeholder"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "customFieldId": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "deleted": {
      "type": "boolean"
    },
    "placeholder": {
      "type": "string"
    }
  }
}
```