Referencia (endpoints)Formularios

Crear un formulario

Úsalo para empezar un formulario de WhatsApp en uno de tus números oficiales, a partir de un modelo: queda como borrador y después le guardas su contenido.

POST
/forms

Permiso requerido: Contactos y conversaciones → Editar

Crea un formulario nuevo como borrador de tu cuenta. Envía template_key (una de las key de GET /forms/templates; blank empieza vacío), device_id (un número de WhatsApp Cloud de tu cuenta) y, si quieres, device_ids con otros números donde también vivirá. Responde 201 con la versión (id), su family_id, lint y numbers. Si un número no es de tu cuenta o no es WhatsApp Cloud responde 422 NUMBER_NOT_ELIGIBLE.

Autorización

http
headerAuthorizationBearer <clave>

Cuerpo del pedido

application/json
  1. body
device_id*string

Id opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^dev_[A-Za-z0-9]{23}$
device_ids?array<>
Elementositems <= 50
template_key*string

Cuerpo de la respuesta

Created

application/json
  1. response
data*
lint*array<unknown>
numbers*array<any>
Elementos1 <= items <= 1
curl -X POST "https://example.com/forms" \  -H "Content-Type: application/json" \  -d '{    "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX",    "template_key": "string"  }'
{  "data": {    "id": "frv_Ath9bJ3RpAYPhnX0EfcLtHJ",    "family_id": "frm_AyJUGabeXUAk9dbBuWegw4B",    "name": "string",    "label": "string",    "category": "string",    "status": "string",    "version": 0,    "definition": [      null    ],    "fields": [      null    ],    "mapping": [      null    ],    "tag_rules": [      null    ],    "has_endpoint": true,    "first_screen": "string",    "first_screen_dynamic": true,    "lint_errors_count": 0,    "draft_id": "frv_Ath9bJ3RpAYPhnX0EfcLtHJ",    "draft_version": 0,    "sends": 0,    "responses": 0,    "meta_flow_id": "string",    "flow_json": [      null    ],    "validation_errors": [      null    ],    "published_at": "string",    "updated_at": "string"  },  "lint": [    null  ],  "numbers": [    {      "device_id": null,      "primary": true,      "status": "string",      "error": "string"    }  ]}

Esto es lo que se copia para tu IA

Cargando…