Variables

Crea una definición de campo de contacto

Declara un campo de contacto nuevo. A partir de ahí ese campo se puede escribir en los contactos y usar como token de variable en las plantillas.

post/variables/field-definitions

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/variables/field-definitions
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Request body

descriptionstring
field_keystring required
labelstring required
option_parentsobject

Con parent_field_key: a qué opción del padre pertenece cada opción de este campo ({ opción: opción del padre }). Una opción sin entrada se ofrece siempre, sea cual sea el valor del padre.

optionsstring[]

select: opciones válidas del campo (texto plano — cada opción es a la vez el valor guardado y la etiqueta visible). currency: un único elemento con el código ISO de la moneda (['COP']). Reusa la misma columna JSONB; para el resto de los tipos se ignora.

parent_field_keystring nullable

Lista dependiente: field_key de otro campo de lista del que depende este. Solo para select. null u omitido = lista independiente.

type'text' | 'number' | 'boolean' | 'date' | 'datetime' | 'json' | 'select' | 'currency' required

Example request

{
  "description": "Whether this contact is a VIP customer",
  "field_key": "vip_status",
  "label": "VIP Status",
  "option_parents": {
    "Interesado": "Contactado",
    "No contesta": "No contactado"
  },
  "options": [
    "Activo",
    "Inactivo",
    "Pausado"
  ],
  "parent_field_key": "estado"
}

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "created_at": "2026-07-30T04:12:33.120Z",
    "description": "Ciudad donde se entrega el pedido",
    "field_key": "ciudad_entrega",
    "id": 17,
    "label": "Ciudad de entrega",
    "option_parents": {},
    "options": [
      "Bogotá",
      "Medellín",
      "Cali"
    ],
    "type": "select",
    "workspace_id": 134
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.