Skip to main content
Custom fields allow you to define and organize additional attributes for your contacts beyond the standard fields (email, phone, name).

​
Use Cases

  • Lead qualification: Store lead score, source, or stage
  • Segmentation: Categorize contacts by industry, plan, or region
  • Personalization: Store preferences for personalized messaging
  • Integration sync: Map external CRM fields to Minimo

​
Field Types

TypeDescription
textFree text input
numberNumeric value
booleanTrue/false
dateDate value
datetimeDate and time
selectSingle selection from options
jsonJSON object

​
Best Practices

Use SNAKE_CASE for keys (e.g., COMPANY_SIZE, LEAD_SOURCE). Keys are automatically uppercased.
Group related fields using categories like “Company Info”, “Lead Data”, “Preferences” for better organization.
Choose the right type for your data. Use number for numeric values, date for dates, and select for predefined options.

​
Common Errors

ErrorCauseSolution
key already existsDuplicate key in accountUse a different key name
validation_errorMissing required fieldsInclude key, displayName, and type
unauthorizedInvalid API keyCheck Authorization header

​
Code Examples

const response = await fetch('https://api.minimo.it/public/v1/custom-fields', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mn-YOUR_CLIENT_ID-YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    key: 'LEAD_SOURCE',
    displayName: 'Lead Source',
    type: 'select',
    category: 'Lead Data'
  })
});
const { data } = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer mn-YOUR_CLIENT_ID-YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.minimo.it/public/v1/custom-fields',
    headers=headers,
    json={
        'key': 'LEAD_SOURCE',
        'displayName': 'Lead Source',
        'type': 'select',
        'category': 'Lead Data'
    }
)
print(response.json())