Saved replies

List the saved replies (snippets) of the Social Inbox

social_inbox.snippets.list

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.

Scope

social_inbox:read

Permission

View the module

MCP tool

social_inbox_snippets_listOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.snippets.list".

Declared cost: up to 500 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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

Get one saved reply (snippet)

social_inbox.snippets.get

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.

Scope

social_inbox:read

Permission

View the module

MCP tool

social_inbox_snippets_getOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.snippets.get".

Declared cost: up to 1 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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

Create a saved reply (snippet)

social_inbox.snippets.create

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.

Scope

social_inbox:write

Permission

Edit in the module

MCP tool

social_inbox_snippets_createOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.snippets.create".

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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"
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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"
}'

Update a saved reply (snippet)

social_inbox.snippets.update

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.

Scope

social_inbox:write

Permission

Edit in the module

MCP tool

social_inbox_snippets_updateOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.snippets.update".

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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": {}
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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 a saved reply (snippet)

social_inbox.snippets.delete

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.

With an API key, this DELETE runs directly: the record stays 30 days in the trash and the response carries its trash_item_id. With an OAuth token, and through the MCP, it needs dry_run → confirm_token.

Scope

social_inbox:write and “Allow deletions” (social_inbox:delete in OAuth)

Permission

Edit in the module

MCP tool

social_inbox_snippets_deleteOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.snippets.delete".

Declared cost: up to 101 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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