---
title: "POST /v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote"
method: POST
path: "/v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote"
tags: ["accounts"]
---

# POST /v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote

`POST /v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote`

## Request

- Base URL: `https://adexchangebuyer.googleapis.com`
- URL: `https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/adexchange.buyer`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/adexchange.buyer`

Create a new note and attach it to the proposal. The note is assigned a unique ID by the server. The proposal revision number will not increase when associated with a new note.

## Path parameters

- `accountId` string, required
- `proposalId` string, required

## Request body

- AddNoteRequest: Request message for adding a note to a given proposal.
  - `note` Note: A proposal may be associated to several notes.
    - `createTime` string, google-datetime: Output only. The timestamp for when this note was created.
    - `creatorRole` 'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER': Output only. The role of the person (buyer/seller) creating the note.
    - `note` string: The actual note to attach. (max-length: 1024 unicode code units) Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error.
    - `noteId` string: Output only. The unique ID for the note.
    - `proposalRevision` string, int64: Output only. The revision number of the proposal when the note is created.

## Response `200`

Successful response

- Note: A proposal may be associated to several notes.
  - `createTime` string, google-datetime: Output only. The timestamp for when this note was created.
  - `creatorRole` 'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER': Output only. The role of the person (buyer/seller) creating the note.
  - `note` string: The actual note to attach. (max-length: 1024 unicode code units) Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error.
  - `noteId` string: Output only. The unique ID for the note.
  - `proposalRevision` string, int64: Output only. The revision number of the proposal when the note is created.

## Changes

- **2026-10-10** `af1a744df07b`: 2 breaking
  - removed the request body
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/adexchangebuyer2/changes/v2beta1/accounts/:accountId/proposals/:proposalId:addNote/post.md)

---

[API](https://skmtc.dev/google/apis/adexchangebuyer2.md) - [All operations](https://skmtc.dev/google/apis/adexchangebuyer2/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/adexchangebuyer2/revisions/0aaaaa1fffb0?raw)