POST
/
v1
/
notes
curl --location --request POST 'https://api.stateset.com/v1/notes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "title": "Important Update",
    "body": "Customer requested expedited shipping",
    "associated_id": "order_123"
}'
{
  "id": "note_001",
  "title": "Important Update",
  "body": "Customer requested expedited shipping",
  "created_date": "2024-01-01T12:00:00Z",
  "last_modified_date": "2024-01-01T12:00:00Z",
  "created_by": "user_123",
  "last_modified_by": "user_123"
}
This endpoint requires authentication with notes:write permission.

Request Parameters

title
string
required
The title or subject of the note
body
string
required
The main content or body of the note
created_by
string
ID or name of the user creating the note (auto-filled if not provided)
associated_id
string
Optional ID of the resource this note is associated with (e.g., order ID)

Response

id
string
Unique identifier for the created note
title
string
The title of the note
body
string
The content of the note
created_date
string
Timestamp when the note was created
last_modified_date
string
Timestamp when the note was last updated
created_by
string
User who created the note
last_modified_by
string
User who last modified the note

Request Example

curl --location --request POST 'https://api.stateset.com/v1/notes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "title": "Important Update",
    "body": "Customer requested expedited shipping",
    "associated_id": "order_123"
}'

Response Example

{
  "id": "note_001",
  "title": "Important Update",
  "body": "Customer requested expedited shipping",
  "created_date": "2024-01-01T12:00:00Z",
  "last_modified_date": "2024-01-01T12:00:00Z",
  "created_by": "user_123",
  "last_modified_by": "user_123"
}