Update a custom field

Article: 000054563

Updated: September 11, 2025

Update a custom field

Abstract

Describes the request and response details of this Moosend API endpoint to update a custom field.

Request

Parameter	In	Type	Required	Description
`Accept`	header	string	true	Determines the expected format and data type to retrieve the response data. Value: `application/json`
`MailingListID`	path	string	true	The ID of the email list containing the custom field.
`CustomFieldID`	path	string	true	The ID of the custom field to be updated.
`Format`	path	string	true	The supported file format for getting a response. Possible values: `json` and `xml`.
`apikey`	query	string	true	The API key of your account.
`Name`	body	string	true	The name of the custom field.
`CustomFieldType`	body	string	false	Specifies the data type of the custom field. This must be one of the following values. `Text` (Default) - accepts any text value as input. `Number` - accepts only numeric values as input. `DateTime` - accepts only date values as input, with or without time. `SingleSelectDropdown` - accepts only values explicitly defined in a list. `CheckBox` - accepts only values of true or false.
`Options`	body	string	false	If you want to update a `SingleSelectDropdown` custom field, you must set this parameter to specify the available options for the user to choose from. Use a comma (,) to separate different options.
`IsRequired`	body	Boolean	false	Specifies whether the custom field is mandatory or not when adding a subscriber to your list. You must specify a value of `true` or `false` (Default).
`IsHidden`	body	Boolean	false	Specifies whether the custom field is visible to your subscribers in the Update Profile page. You must specify a value of `true` or `false` (Default).

Response

Status	Description	Headers	Schema
`200 OK`	The request is successful.	`Content-Type:application/json`	N/A

Code - the response code. This is 0 if successful.
Error - the response error message. This is null if successful.
Context - this is null if successful.

Request

POST https://{hostname}/v3/lists/{MailingListID}/customfields/{CustomFieldID}/update.{Format}?apikey=

Request body:
{
  "Name": "City",
  "CustomFieldType": "SingleSelectDropdown",
  "Options": "Frankfurt,London,Paris,Rome"
}

Request

curl --include \
     --request POST \
     --header "Content-Type: application/json" \
     --header "Accept: application/json" \
     --data-binary "{
    \"Name\": \"City\",
    \"CustomFieldType\":\"SingleSelectDropdown\",
    \"Options\":\"Frankfurt,London,Paris,Rome\"
}" \
'https://{hostname}/v3/lists/{MailingListID}/customfields/{CustomFieldID}/update.{Format}?apikey='

Response

json

{
  "Code": 0,
  "Error": null,
  "Context": "null"
}

Choose your product

topic label

topic title

View More

subtopic title

View More

Video Tutorials

subtopic name

article title

QuickStart Guides

title

What's New

Latest Product Updates

Update a custom field

Update a custom field

Request

Response

Questions?

Give Feedback

Related Answers