Atualizar Oportunidade

PUT /external/v1/opportunities/:id

Atualiza uma oportunidade existente. Apenas os campos fornecidos serao atualizados.

Autenticacao

Requer permissao opportunities:write.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	O identificador unico da oportunidade

Corpo da Requisicao

Todos os campos sao opcionais. Inclua apenas os campos que deseja atualizar.

Campo	Tipo	Descricao
name	string	Nome completo
email	string	Endereco de e-mail
phone	string	Numero de telefone
company	string	Nome da empresa
position	string	Cargo
deal_value	number	Valor do negocio
deal_currency	string	Codigo da moeda
notes	string	Observacoes adicionais
responsible_user_id	string	ID do usuario responsavel

TIP

Para atualizar o status/estagio da oportunidade, use o endpoint Atualizar Estagio.

Requisicao

cURL

curl --request PUT \
  --url "https://app.getraze.com/external/v1/opportunities/opp_abc123def456" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "deal_value": 100000,
    "notes": "Upgraded to enterprise package"
  }'

Node.js

const axios = require('axios');

const opportunityId = 'opp_abc123def456';

const response = await axios.put(
  `https://app.getraze.com/external/v1/opportunities/${opportunityId}`,
  {
    deal_value: 100000,
    notes: 'Upgraded to enterprise package'
  },
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

Python

import requests

opportunity_id = 'opp_abc123def456'

response = requests.put(
    f'https://app.getraze.com/external/v1/opportunities/{opportunity_id}',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'deal_value': 100000,
        'notes': 'Upgraded to enterprise package'
    }
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "opp_abc123def456",
    "name": "John Doe",
    "email": "john@example.com",
    "company": "Acme Inc",
    "status": "qualified",
    "deal_value": 100000.00,
    "deal_currency": "BRL",
    "notes": "Upgraded to enterprise package",
    "updated_at": "2024-01-25T10:00:00Z"
  }
}

Erros

Status	Codigo	Descricao
400	VALIDATION_ERROR	Valores de campos invalidos
404	NOT_FOUND	Oportunidade nao encontrada