Delete Custom User Field

DELETE

/apis/v1/communities/{communityId}/user-fields/{fieldIdOrName}

This endpoint deletes an custom user field in a community.

Authorization

Bearer token Required

Found in the platform under community settings > API keys.
Permission: User Fields

Community ID

Community ID is needed in the path.

Found in the platform under community settings > Appearance.

Field ID or name

The unique identifier (ObjectId) or name (string) of the custom user field to update. There are 2 methods to get the field ID or name

Via API
Use the Get All User Fields endpoint to retrive all fields, use the _id or field in the response.

Via community settings
In the community settings > User Fields, the Field name and Field ID can be found in each field column.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

Delete user field successful

Body

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/apis/v1/communities//user-fields/' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "meta": {
        "status": "success",
        "statusCode": 200
    },
    "message": "Delete user field successful",
    "data": {
        "_id": "6857de260f3c24d98fd7ca85",
        "name": "Total Points",
        "field": "total_points",
        "type": "number"
    }
}

Modified at 2026-03-24 09:39:51

Update Custom User Field

Integration API

Delete Custom User Field

Authorization#

Community ID#

Field ID or name#

Request

Responses

Authorization

Community ID

Field ID or name