Atualizar Oportunidade

PUT /external/v1/opportunities/:id

Atualiza uma oportunidade existente e o contato vinculado. Apenas os campos fornecidos serao atualizados.

Autenticacao

Requer permissao opportunities:write.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	Identificador unico da oportunidade

Corpo da Requisicao

Todos os campos sao opcionais. Campos de contato atualizam o contato vinculado; campos de oportunidade atualizam a propria oportunidade.

Campo	Tipo	Descricao
name	string	Nome do lead (atualiza nome do contato e titulo da oportunidade)
title	string	Cargo/posicao do contato
company	string	Empresa
location	string	Localizacao
headline	string	Headline do contato
profile_url	string	URL do perfil
profile_picture	string	URL da foto de perfil
email	string	E-mail
phone	string	Telefone
score	number	Score do lead
notes	string	Notas adicionais
owner_user_id	string	Vendedor responsavel
pipeline_id	string	Pipeline
stage_id	string	Etapa

TIP

Para mover a oportunidade entre etapas com timestamps de ciclo de vida automaticos e motivo de perda opcional, 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 '{
    "score": 95,
    "notes": "Upgrade para pacote enterprise"
  }'

Node.js

const axios = require('axios');

const opportunityId = 'opp_abc123def456';

const response = await axios.put(
  `https://app.getraze.com/external/v1/opportunities/${opportunityId}`,
  {
    score: 95,
    notes: 'Upgrade para pacote enterprise'
  },
  {
    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={
        'score': 95,
        'notes': 'Upgrade para pacote enterprise'
    }
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "opp_abc123def456",
    "title": "Acme Inc - Plano Pro",
    "score": 95,
    "notes": "Upgrade para pacote enterprise",
    "pipeline_id": "pipe_01",
    "stage_id": "stg_proposal",
    "contact_id": "cnt_abc123",
    "contact_name": "John Doe",
    "contact_email": "john@example.com",
    "contact_company": "Acme Inc",
    "contact_title": "CEO",
    "owner_user_name": "Maria Silva",
    "updated_at": "2026-01-25T10:00:00Z"
  }
}

Erros

Status	Codigo	Descricao
400	VALIDATION_ERROR	Nenhum campo fornecido para atualizar
404	NOT_FOUND	Oportunidade nao encontrada