---
title: "Criar anotação na negociação"
method: POST
path: "/deals/{deal_id}/notes"
tags: ["crm-v2-notes"]
---

# Criar anotação na negociação

`POST /deals/{deal_id}/notes`

## Request

- Base URL: `https://api.rd.services/crm/v2`
- URL: `https://api.rd.services/crm/v2/deals/{deal_id}/notes`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`

Adiciona uma nova anotação em uma negociação específica. É o caminho para automatizar a entrada de registros de chamadas, resumos de reuniões ou qualquer outra informação relevante para a venda.

## Path parameters

- `deal_id` string, required

## Request body

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `description` string: Texto da anotação.
    - `user_id` string: ID do usuário que criou a anotação.
    - `registered_at` string, date-time: Data que a anotação foi criada.
    - `pinned_at` string, date-time: Data que a anotação foi fixada.
    - `edited_by_id` string: ID do usuário que editou a anotação.
    - `edited_at` string, date-time: Data de edição da anotação.

## Response `201`

Created

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `description` string: Texto da anotação.
    - `user_id` string: ID do usuário que criou a anotação.
    - `registered_at` string, date-time: Data que a anotação foi criada.
    - `pinned_at` string, date-time: Data que a anotação foi fixada.
    - `edited_by_id` string: ID do usuário que editou a anotação.
    - `edited_at` string, date-time: Data de edição da anotação.

## Other responses

- `400`: A requisição está malformada e não consegue ser processada.
- `401`: O token da API está ausente ou inválido.
- `403`: O token não tem permissão para acessar o recurso solicitado.
- `422`: A entidade não pode ser processada.
- `429`: O limite de requisições foi excedido.
- `500`: Erro interno ou inesperado no servidor.

---

[API](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/revisions/10d0a25b8c54?raw)
