Menú

Referencia de la API · Inbox

Respuestas guardadas

social_inbox · snippets · 5 operaciones

GET/v1/social-inbox/snippetsList the saved replies (snippets) of the Social Inbox GET/v1/social-inbox/snippets/{snippet_id}Get one saved reply (snippet)POST/v1/social-inbox/snippetsCreate a saved reply (snippet)PATCH/v1/social-inbox/snippets/{snippet_id}Update a saved reply (snippet)DELETE/v1/social-inbox/snippets/{snippet_id}Delete a saved reply (snippet)

GET/v1/social-inbox/snippets

List the saved replies (snippets) of the Social Inbox

social_inbox.snippets.list

LecturaIdempotenteDesde 2026-11-01

Lists the saved replies of the inbox by name (up to 500): name, body with {{variables}} (name, nombre and username are filled from the item's author), category, locale, tone and how many times they were used. locale filters by language (es, en, pt…). Requires view access to the Social Inbox.

Alcance: social_inbox:read
Permiso: Ver el módulo
Tool del MCP: social_inbox_snippets_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.snippets.list".

Costo declarado: hasta 500 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

localestringqueryopcional

Only saved replies in this language (es, en, pt-BR…).

Respuesta

dataarray<object>

Errores

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/social-inbox/snippets" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/social-inbox/snippets" \
  -H "Authorization: Bearer $MB_TEST_KEY"

GET/v1/social-inbox/snippets/{snippet_id}

Get one saved reply (snippet)

social_inbox.snippets.get

LecturaIdempotenteDesde 2026-11-01

Returns one saved reply of the inbox with its body, variables, category, locale, tone and usage count. 404 inbox_snippet_not_found if it is not in this organization. Requires view access.

Alcance: social_inbox:read
Permiso: Ver el módulo
Tool del MCP: social_inbox_snippets_getEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.snippets.get".

Costo declarado: hasta 1 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

snippet_idstringrutarequerido

The saved reply id (from social_inbox.snippets.list).

Respuesta

idstring

The saved reply id.

namestring

Its name.

bodystring

Its text, with optional {{variables}}: {{name}} or {{nombre}} (the author's first name) and {{username}} are filled in when a rule sends it; unknown ones are removed.

localestring

Its language (es, en, pt-BR…).

tonestring

formal, friendly, brief, empathetic or neutral.

usage_countnumber

How many times it was used from the composer.

categorystring | null

Its category, if any.

variablesarray<string> | null

The {{variables}} its body uses.

created_atnumber | null

When it was created (epoch ms).

created_by_idstring | null

Who created it.

updated_atnumber | null

Last edit (epoch ms).

updated_by_idstring | null

Who edited it last.

Errores

inbox_snippet_not_found invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/social-inbox/snippets/{snippet_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/social-inbox/snippets/{snippet_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/social-inbox/snippets

Create a saved reply (snippet)

social_inbox.snippets.create

EscrituraDesde 2026-11-01

Creates a saved reply for the inbox: name (up to 120 characters), body (up to 8,192; {{name}}, {{nombre}} and {{username}} are filled from the item's author, unknown variables are dropped before sending), optional category, locale (default es) and tone (formal, friendly, brief, empathetic, neutral; default neutral). Up to 500 per organization (409 limit_reached, details.resource inbox_snippets). Returns it with its id. Requires full access and an owner, admin or member role.

Alcance: social_inbox:write
Permiso: Editar en el módulo
Tool del MCP: social_inbox_snippets_createEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.snippets.create".

Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

namestringcuerporequerido

Its name (what the composer shows).

bodystringcuerporequerido

Its text; {{name}}, {{nombre}} (the author's first name) and {{username}} are filled in when a rule sends it.

categorystringcuerpoopcional

Optional category to group saved replies.

localestringcuerpoopcional

Its language (es, en, pt-BR…). Default es.

Por defecto: "es"

toneenumcuerpoopcional

formal, friendly, brief, empathetic or neutral (the default).

Valores: formal, friendly, brief, empathetic, neutral · Por defecto: "neutral"

Respuesta

snippet_idstring

snippetobject

Errores

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/social-inbox/snippets" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "body": "BODY"
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/social-inbox/snippets" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "body": "BODY"
}'

PATCH/v1/social-inbox/snippets/{snippet_id}

Update a saved reply (snippet)

social_inbox.snippets.update

EscrituraIdempotenteDesde 2026-11-01

Updates a saved reply: only what comes in updates changes (name, body, category, locale, tone; category null removes it); the variables are recalculated from the new body. Rules that reply with it use the new text from then on. 404 inbox_snippet_not_found if it does not exist. Returns it. Requires full access and an owner, admin or member role.

Alcance: social_inbox:write
Permiso: Editar en el módulo
Tool del MCP: social_inbox_snippets_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.snippets.update".

Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

snippet_idstringrutarequerido

The saved reply id (from social_inbox.snippets.list).

updatesobjectcuerporequerido

What changes (only what comes is written).

Respuesta

snippetobject

Errores

inbox_snippet_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/social-inbox/snippets/{snippet_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/social-inbox/snippets/{snippet_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

DELETE/v1/social-inbox/snippets/{snippet_id}

Delete a saved reply (snippet)

social_inbox.snippets.delete

IrreversibleDesde 2026-11-01

Deletes a saved reply. It stays 30 days in the trash; active rules that reply with it stop replying until it is restored with the same id (the dry run lists them). Outside the screen it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. Requires full access and an owner, admin or member role.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance: social_inbox:write y «Permitir eliminar» (social_inbox:delete en OAuth)
Permiso: Editar en el módulo
Tool del MCP: social_inbox_snippets_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.snippets.delete".

Costo declarado: hasta 101 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

snippet_idstringrutarequerido

The saved reply id (from social_inbox.snippets.list).

Respuesta

oktrue

trash_item_idstring

The trash item this deletion left: the item_id of platform.trash.restore (POST /trash/{item_id}/restore). Missing if nothing went to the trash.

trash_item_idsarray<string>

Only when the deletion left more than one copy: all of them, the first being trash_item_id.

trash_expires_atnumber

When the copy leaves the trash for good (epoch ms): 30 days after the deletion.

Errores

inbox_snippet_not_found delete_not_allowed confirmation_required invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/social-inbox/snippets/{snippet_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X DELETE "https://api.mb-suite.com/v1/social-inbox/snippets/{snippet_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"