> For the complete documentation index, see [llms.txt](https://api.senderwiz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.senderwiz.com/customer/fields/delete-a-list-field.md).

# Delete a List Field

Permanently delete a custom field from a subscriber list using its list UID and field ID. This is useful for cleaning up unused or outdated fields.

### 🗑️ Delete a List Field

Delete a specific custom field from a subscriber list using its list UID and field ID. \
This action is permanent and cannot be undone.

#### 🔹 HTTP Request

```http
DELETE API-URL/lists/LIST-UNIQUE-ID/fields/FIELD-ID
```

#### 🔸 URL Segments

| Segment          | Required | Description                          |
| ---------------- | -------- | ------------------------------------ |
| `LIST-UNIQUE-ID` | Yes      | Unique identifier of the list.       |
| `FIELD-ID`       | Yes      | Unique identifier of the list field. |

#### 🔐 Authorization Header

```
X-API-KEY: your-api-key-here
```

***

#### 💻 PHP Example

```php
// Delete FIELD
$response = $endpoint->delete('LIST-UNIQUE-ID', 'FIELD-ID');

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';
```

***

#### 📦 Sample JSON Response

```json
{
  "status": "success"
}
```

> ⚠️ Deleting a field will remove it from all list forms and subscriber records associated with this list.

***

####