Menú

Referencia de la API · Partners

Invitaciones

partners · invitations · 5 operaciones

GET/v1/partners/invitationsList the partner invitations sent by the workspace GET/v1/partners/invitations/{invitation_id}Get one partner invitation POST/v1/partners/invitationsInvite another organization to become an account of the workspace POST/v1/partners/invitations/{invitation_id}/resendResend a pending partner invitation POST/v1/partners/invitations/{invitation_id}/cancelCancel a pending partner invitation

GET/v1/partners/invitations

List the partner invitations sent by the workspace

partners.invitations.list

LecturaIdempotenteDesde 2026-11-01

Lists the partner invitations this workspace sent, newest first, paginated by cursor (limit up to 200). A partner invitation asks the owner of ANOTHER organization (by email) to link it as an account of the workspace; that organization keeps paying its own subscription. Each invitation: recipient_email, status (pending, expired = pending but past expires_at, accepted, declined, cancelled), who sent it, created_at, expires_at (7 days after sending or the last resend), responded_at, cancelled_at and, once accepted, child_org_id and child_org_name (the new account, see platform.orgs.get). Filter with status (or all, the default); a filtered page is filled up to limit while reading (up to 500 invitations per page; then has_more says whether more follow). Only workspaces send invitations: called on an Account (org_id of an Account) it is 400, run it without org_id. Owners and admins only.

Alcance: partners:read
Permiso: Ver el módulo · Solo owner, admin
Tool del MCP: partners_invitations_listEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.invitations.list".

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

Parámetros

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

statusenumqueryopcional

Only the invitations in this status (expired: pending past their 30 days), or all (the default).

Valores: pending, expired, accepted, declined, cancelled, all

Respuesta

dataarray<object>

has_moreboolean

next_cursorstring

Errores

role_required 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/partners/invitations" \
  -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/partners/invitations" \
  -H "Authorization: Bearer $MB_TEST_KEY"

GET/v1/partners/invitations/{invitation_id}

Get one partner invitation

partners.invitations.get

LecturaIdempotenteDesde 2026-11-01

Returns one partner invitation sent by this workspace, with the same fields as partners.invitations.list (status expired means pending but past expires_at: it can still be resent or cancelled, no longer accepted). An invitation sent by another organization is not found (partner_invitation_not_found). Owners and admins only.

Alcance: partners:read
Permiso: Ver el módulo · Solo owner, admin
Tool del MCP: partners_invitations_getEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.invitations.get".

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

Parámetros

invitation_idstringrutarequerido

The partner invitation id (partners.invitations.list).

Respuesta

idstring

statusenum

Valores: pending, expired, accepted, declined, cancelled

recipient_emailstring

parent_org_idstring

parent_org_namestring

invited_bystring

invited_by_namestring

invited_by_emailstring

created_atnumber

expires_atnumber

responded_atnumber | null

cancelled_atnumber | null

child_org_idstring | null

child_org_namestring | null

Errores

partner_invitation_not_found role_required 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/partners/invitations/{invitation_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/partners/invitations/{invitation_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/partners/invitations

Invite another organization to become an account of the workspace

partners.invitations.send

EscrituraDesde 2026-11-01

SENDS a partner invitation by email (Amazon SES, from MB Suite, in the inviter's language) to the owner of another organization (email; recipient_email, its name in the output, is accepted too): it can accept it from MB Suite (Settings → Partners) within 7 days, choosing one of the organizations it owns, which then becomes an account of this workspace while it keeps paying its own subscription (on an internal or paying workspace, its base price moves to the partner tier from its next invoice). Accepting and declining are done by the invited person in the app, never through the API (partners.invitation.accepted / partners.invitation.declined fire). Only a workspace can invite (partners_workspace_only), and it takes a direct owner or admin with edit access to Accounts (partners_accounts_access_required: only agency workspaces link accounts). Errors: partner_invitation_email_invalid, partner_invitation_exists (409, a pending invitation for that email already exists: resend or cancel it; details.invitation_id), partner_invitation_own_member (the email belongs to a member of the workspace). It reaches a real inbox: confirm the address with the person first. Returns the invitation.

Instrucciones para agentes

Tell the person the invitation was emailed and that the other organization has 7 days to accept it from MB Suite (Settings → Partners).

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: partners:write
Permiso: Editar en el módulo · Solo owner, admin
Tool del MCP: partners_invitations_sendEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.invitations.send".
Eventos que puede emitir: partners.invitation.sent

Costo declarado: hasta 2 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.

Parámetros

emailstringcuerpoopcional

The email of the owner of the organization to link (recipient_email is accepted too).

recipient_emailstringcuerpoopcional

Same as email: the name the invitation shows it with in the output.

Respuesta

invitation_idstring

invitationobject

Errores

confirmation_required role_required external_rejected external_unavailable external_rate_limited external_outcome_unknown sandbox_external_unavailable 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/partners/invitations" \
  -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. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.

POST/v1/partners/invitations/{invitation_id}/resend

Resend a pending partner invitation

partners.invitations.resend

EscrituraDesde 2026-11-01

Emails a pending partner invitation again (Amazon SES) and gives it 7 more days from now (expires_at moves); it also revives an expired one (status expired). Only pending invitations (partner_invitation_not_pending, 409, once accepted, declined or cancelled). Same permissions as partners.invitations.send: a direct owner or admin with edit access to Accounts. It reaches a real inbox again: run it only when the person asks. Returns the invitation.

Alcance: partners:write
Permiso: Editar en el módulo · Solo owner, admin
Tool del MCP: partners_invitations_resendEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.invitations.resend".
Eventos que puede emitir: partners.invitation.sent

Costo declarado: hasta 2 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.

Parámetros

invitation_idstringrutarequerido

The partner invitation id (partners.invitations.list).

Respuesta

invitationobject

Errores

partner_invitation_not_found confirmation_required role_required external_rejected external_unavailable external_rate_limited external_outcome_unknown sandbox_external_unavailable 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/partners/invitations/{invitation_id}/resend" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

Probar con tu API key de prueba

POST/v1/partners/invitations/{invitation_id}/cancel

Cancel a pending partner invitation

partners.invitations.cancel

EscrituraIdempotenteDesde 2026-11-01

Cancels a pending (or expired) partner invitation: its link stops working and the invited organization can no longer accept it; nobody is emailed. The invitation stays in the list as cancelled (nothing is deleted). Idempotent: on an invitation already cancelled nothing changes (changed=false); an accepted or declined one is partner_invitation_not_pending (409). A direct owner or admin with edit access to Accounts. Returns the invitation.

Alcance: partners:write
Permiso: Editar en el módulo · Solo owner, admin
Tool del MCP: partners_invitations_cancelEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.invitations.cancel".
Eventos que puede emitir: partners.invitation.cancelled

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

Parámetros

invitation_idstringrutarequerido

The partner invitation id (partners.invitations.list).

Respuesta

invitationobject

changedboolean

Errores

partner_invitation_not_found role_required 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/partners/invitations/{invitation_id}/cancel" \
  -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/partners/invitations/{invitation_id}/cancel" \
  -H "Authorization: Bearer $MB_TEST_KEY"