1. Custom Fields
Maildesk API
  • Maildesk Webhook
  • API Authentication
  • Subscribers
    • Create a new subscriber
      POST
    • Create up to 100 subscribers in a single request
      POST
    • Get a subscriber by ID
      GET
    • Delete a subscriber
      DELETE
    • Update a subscriber
      PUT
    • Get all subscribers
      GET
  • Tags
    • Get all tags
      GET
    • Create a new tag
      POST
    • Get a tag by ID
      GET
    • Update a tag
      PUT
    • Delete a tag
      DELETE
  • Custom Fields
    • List custom fields
      GET
    • Create a custom field
      POST
    • Update a custom field
      PUT
    • Delete a custom field
      DELETE
  • Schemas
    • Schemas
    • ContactApiResponse
    • CustomFieldDataType
    • UpdateContactAPIRequest
    • CreateCustomFieldRequest
    • PaginatedApiResponse
    • UpdateCustomFieldRequest
    • CreateContactAPIRequest
    • CustomField
    • PaginatedTagsApiResponse
    • BulkCreateContactAPIRequest
    • CustomFieldResponse
    • CreateTagApiRequest
    • BulkContactApiResponse
    • CustomFieldListResponse
    • TagApiResponse
    • CustomFieldValues
    • UpdateTagApiRequest
    • CreateSubscriberRequest
    • ContactResponseDto
    • BulkCreateSubscribersRequest
    • TagResponse
    • UpdateSubscriberRequest
    • Subscriber
    • BulkContactFailure
    • SubscriberResponse
    • BulkSubscriberFailure
    • BulkSubscribersResponse
    • Error
  1. Custom Fields

List custom fields

GET
/api/custom-fields
Retrieve every custom field defined for your account, oldest first.

Request

None

Responses

🟢200
application/json
Custom fields retrieved
Bodyapplication/json

🟠401Unauthorized
🟠403EmailNotVerified
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.maildesk.io/api/custom-fields'
Response Response Example
200 - Success
{
    "customFields": [
        {
            "id": "01JA2Z3NDEKTSV4RRFFQ69G5FA",
            "key": "latest_destination",
            "label": "Latest Destination",
            "dataType": "text",
            "mergeTag": "{{customFields.latest_destination}}",
            "createdAt": "2026-10-07T10:00:00.000Z",
            "updatedAt": "2026-10-07T10:00:00.000Z"
        }
    ]
}
Modified at 2026-10-08 06:32:45
Previous
Delete a tag
Next
Create a custom field
Built with