> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.recurrente.com/referencia-api/api-reference/feedback/create-feedback/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server. # Enviar feedback o una sugerencia POST https://app.recurrente.com/api/feedback Content-Type: application/json Crea una Sugerencia desde una integración o agente, sin iniciar una sesión web. Requiere una llave de cuenta con permiso de escritura; no necesita permiso para mover dinero. Las llaves de solo lectura y de organización reciben 403. La cuenta se determina por la llave y, opcionalmente, X-ACCOUNT-ID para una hija directamente conectada. El contacto asociado es el creador de esa cuenta, no una identidad humana autenticada por el agente. No acepta user_id ni account_id en el cuerpo. En LIVE encola la misma notificación interna de Sugerencias; en Sandbox solo guarda el registro aislado, sin notificar. Envía category (feature, bug u other) y una description no vacía. La descripción usa el mismo texto enriquecido y sanitización de Sugerencias; la respuesta devuelve texto plano. No incluyas credenciales ni datos de pago sensibles. Usa Idempotency-Key al reintentar: durante 24 horas, la misma llave y cuerpo devuelven la respuesta original sin crear otra sugerencia. Sin esa cabecera, el texto repetido para la misma cuenta y contacto en cinco minutos recibe 400, incluso si cambias la categoría. Un 201 confirma recepción, no una promesa de implementación. No hay endpoints para listar, editar o borrar feedback. Reference: https://docs.recurrente.com/referencia-api/api-reference/feedback/create-feedback ## Authentication - `X-SECRET-KEY` header (required) — Tu clave secreta de API. Una llave de cuenta (`sk_live_...`, `sk_test_...`) opera sobre su propia cuenta y, con `X-ACCOUNT-ID`, sobre sus cuentas conectadas. La llave también fija el ambiente: una `sk_test_` solo lista y resuelve objetos de prueba (`live_mode: false`) y una `sk_live_` solo objetos reales. Un ID del otro ambiente responde `404` (`401` en `/customers`). Una llave de organización (`sk_org_live_...`, `sk_org_test_...`) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con `X-ACCOUNT-ID`; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde `403` con `code: organization_key_unsupported`. ## Request ### Headers - `Idempotency-Key` (string, optional) — Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header `Idempotency-Replayed: true`); reusarla con parámetros distintos devuelve 409. ### Body (application/json) This endpoint expects an object. - `category` (enum, required) — Tipo de feedback: feature (función nueva), bug (error) u other (otro comentario). - Allowed values: `feature`, `bug`, `other` - `description` (string, required) — Qué ocurrió, qué esperabas y los pasos para reproducirlo, o la función que necesitas. ## Response ### 201 Feedback registrado - `id` (long, required) — Identificador de la Sugerencia recibida. - `category` (enum, required) - Allowed values: `feature`, `bug`, `other` - `description` (string, required) — Descripción sanitizada en texto plano. - `created_at` (datetime, required) ## Errors ### 400 Bad Request Error Categoría inválida, descripción vacía o sugerencia repetida dentro de cinco minutos. errors identifica los campos, o base para duplicados. - `message` (string, optional) — Mensaje de error - `code` (string, optional) — Código estable legible por máquinas, cuando aplica - `refund_id` (string, optional) — ID del reembolso relacionado cuando aplica - `endpoint` (string, optional) — Acción de API rechazada, cuando aplica - `errors` (ErrorErrors, optional) — Detalles de errores por campo ### 401 Unauthorized Error Llave ausente, inválida o vencida. - `any` ### 403 Forbidden Error Llave de solo lectura (read_only_api_key) o de organización (organization_key_unsupported). - `any` ### 404 Not Found Error La cuenta indicada por X-ACCOUNT-ID no es una hija directamente conectada (connected_account_not_found). - `any` ### 409 Conflict Error Idempotency-Key reutilizada con otro cuerpo (idempotency_key_reused) o una solicitud todavía en curso (idempotency_key_in_progress). - `any` ## Types ### ErrorErrors Detalles de errores por campo ## Examples **Request** ```json { "category": "bug", "description": "Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario." } ``` **Response** ```json { "id": 123, "category": "bug", "description": "Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario.", "created_at": "2026-09-29T05:00:00Z" } ``` **SDK Code** ```python Feedback_createFeedback_example import requests url = "https://app.recurrente.com/api/feedback" payload = { "category": "bug", "description": "Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario." } headers = { "X-SECRET-KEY": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Feedback_createFeedback_example const url = 'https://app.recurrente.com/api/feedback'; const options = { method: 'POST', headers: {'X-SECRET-KEY': '', 'Content-Type': 'application/json'}, body: '{"category":"bug","description":"Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario."}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Feedback_createFeedback_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://app.recurrente.com/api/feedback" payload := strings.NewReader("{\n \"category\": \"bug\",\n \"description\": \"Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario.\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-SECRET-KEY", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Feedback_createFeedback_example require 'uri' require 'net/http' url = URI("https://app.recurrente.com/api/feedback") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-SECRET-KEY"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"category\": \"bug\",\n \"description\": \"Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario.\"\n}" response = http.request(request) puts response.read_body ``` ```java Feedback_createFeedback_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://app.recurrente.com/api/feedback") .header("X-SECRET-KEY", "") .header("Content-Type", "application/json") .body("{\n \"category\": \"bug\",\n \"description\": \"Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario.\"\n}") .asString(); ``` ```php Feedback_createFeedback_example request('POST', 'https://app.recurrente.com/api/feedback', [ 'body' => '{ "category": "bug", "description": "Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario." }', 'headers' => [ 'Content-Type' => 'application/json', 'X-SECRET-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp Feedback_createFeedback_example using RestSharp; var client = new RestClient("https://app.recurrente.com/api/feedback"); var request = new RestRequest(Method.POST); request.AddHeader("X-SECRET-KEY", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"category\": \"bug\",\n \"description\": \"Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario.\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Feedback_createFeedback_example import Foundation let headers = [ "X-SECRET-KEY": "", "Content-Type": "application/json" ] let parameters = [ "category": "bug", "description": "Mi agente no puede completar el paso final. Esperaba recibir una confirmación después de enviar el formulario." ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://app.recurrente.com/api/feedback")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```