Gerador de Matrículas icon

Gerador de Matrículas

Interaja com a API do Gerador de Matrículas CRM

Actions33

Negócio → Alterar Status

AI-generated

Summary

Change the status of a Negócio (lead) record by specifying its ID and the new status value, optionally including a loss reason if marking the lead as lost.

Inputs

  • authentication (required) — Select the authentication method to connect to the API: either 'Token de API' or 'OAuth2'.
  • id (required) — ID of the Negócio (lead) record whose status you want to change.
  • status (required) — The new status for the Negócio, options are 'Aberto' (open), 'Ganho' (won), or 'Perdido' (lost).
  • lossReason — Reason for loss; this optional string is only used if setting the status to 'Perdido' (lost).

Output shape

a single record representing the updated Negócio resource

The operation returns the updated Negócio data in JSON format as a single item output. If an error occurs, and 'Continue on Fail' is enabled, an item with the error message is returned instead.

Examples

Example 1: Set the status of a Negócio to 'Ganho' using API Token authentication

Provide authentication method as apiToken, set the target Negócio ID, and specify 'won' as the new status.

Links

Discussion