Metas

List sales goals

crm.goals.list

Lists the sales goals (targets) of the org, newest period first, paginated by cursor (limit up to 200): metric (revenue_won, deals_won, deals_created, activities_logged, calls_made, meetings_held), target, period with its start and end dates (calendar periods in UTC) and is_active (today falls inside it), team or individual owner with user_name, optional pipeline with pipeline_name, and the current value with when it was last computed. Whoever cannot see everyone's performance only gets the team goals and their own.

Alcance

crm:read

Permiso

Ver el módulo

Tool del MCP

crm_goals_listEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.goals.list".

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

Parámetros

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/crm/goals" \
  -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/crm/goals" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a sales goal

crm.goals.create

Creates a sales goal: metric, positive target, period (monthly, quarterly or yearly; the bounds snap to the calendar period that contains start_date, today by default), team_scope team or individual (individual needs user_id, a member of the org; a team goal has no owner and any user_id sent is ignored), optional pipeline_id and name. The current value is computed right away. The dry run runs the same checks (same errors: goal_owner_required, goal_owner_not_member) and its preview computes the value the goal would start with (counts goals, current_value, target and percent, the % of the target with one decimal) and says the metric, the period with its dates and the scope. Requires manage_goals (CRM admins).

Alcance

crm:write

Permiso

Editar en el módulo · Acción del CRM: manage_goals

Tool del MCP

crm_goals_createEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.goals.create".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/crm/goals" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "team_scope": "individual",
  "metric": "revenue_won",
  "target": 0,
  "period": "monthly"
}'

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/crm/goals" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "team_scope": "individual",
  "metric": "revenue_won",
  "target": 0,
  "period": "monthly"
}'

Update a sales goal

crm.goals.update

Updates a goal's name, metric, target, team scope, owner (user_id), pipeline (null = all pipelines) or period; with none of them it answers no_changes (crm.goals.refresh recomputes the value). A team goal has no owner: moving a goal to team (or saving any change on a team goal that still kept one) clears user_id, so its progress counts the whole team. An individual goal needs an owner: a change to the scope or the owner that would leave it individual without user_id is goal_owner_required, and user_id must be a member (goal_owner_not_member). Changing the period moves the bounds to the calendar period of today. The current value is recomputed after saving. The dry run runs the same checks (same errors) and its preview computes the value with the change (counts goals, current_value, target, percent and previous_value, the value saved today), says the resulting metric, period dates and scope, and warns when the owner is cleared or the dates move. Requires manage_goals.

Alcance

crm:write

Permiso

Editar en el módulo · Acción del CRM: manage_goals

Tool del MCP

crm_goals_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.goals.update".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/crm/goals/{goal_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 PATCH "https://api.mb-suite.com/v1/crm/goals/{goal_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Delete a sales goal

crm.goals.delete

Deletes a goal for good: goals have no trash, so it cannot be restored (the deals and activities it measured are untouched). Use crm.goals.update to change a goal instead of deleting and recreating it. Requires manage_goals.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

crm:write y «Permitir eliminar» (crm:delete en OAuth)

Permiso

Editar en el módulo · Acción del CRM: manage_goals

Tool del MCP

crm_goals_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.goals.delete".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/crm/goals/{goal_id}/delete" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

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/crm/goals/{goal_id}/delete" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

Recompute a goal's current value

crm.goals.refresh

Recomputes a goal's current value now from the deals or activities of its period (a daily job already does it for every goal) and returns it. Safe to repeat. The dry run computes the value without saving it (counts goals, current_value, target, percent and previous_value, the value saved today; the text says the metric and the period dates). Anyone with access to the CRM can refresh, as in the goals panel; it does not change the goal itself.

Alcance

crm:write

Permiso

Ver el módulo

Tool del MCP

crm_goals_refreshEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.goals.refresh".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/crm/goals/{goal_id}/refresh" \
  -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 POST "https://api.mb-suite.com/v1/crm/goals/{goal_id}/refresh" \
  -H "Authorization: Bearer $MB_TEST_KEY"