Ricky logorickyDocs

Crear un campo de contacto

POST
/contact-fields

Agrega un campo personalizado a todos los contactos, después de los existentes. Un nombre ya usado, en mayúsculas o minúsculas, responde 409 conflict.

Permiso: contacts:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la solicitud

application/json
  1. body

Un campo personalizado de contacto. Su ID es la clave en custom_values.

name*string

Nombre visible, único en la organización sin importar mayúsculas o minúsculas.

Longitud1 <= length <= 60
type*string

Tipo de valor. No se puede cambiar después.

Uno de"text""long_text""number""boolean""date""select""multi_select"
options?array<>

Valores permitidos; obligatorios para select y multi_select, rechazados en los demás.

Elementositems <= 100

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Un campo de contacto personalizado que define la organización.

curl -X POST 'https://getricky.ai/api/v1/contact-fields' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "name": "Sucursal",  "type": "select",  "options": [    "Albrook Mall",    "Multiplaza"  ]}'
{  "data": {    "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",    "name": "Sucursal",    "type": "text",    "options": [      "Albrook Mall",      "Multiplaza"    ]  }}