Skip to main content
POST
/
v1
/
inbound
/
notes
Create Note
curl --request POST \
  --url https://enrich.octolane.com/v1/inbound/notes \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "note": {
    "title": "<string>",
    "content": "<string>"
  },
  "account_domains": [
    "<string>"
  ],
  "contact_emails": [
    "<string>"
  ]
}
'
{
  "success": true,
  "data": {
    "note_id": "<string>",
    "title": "<string>",
    "content": "<string>"
  },
  "message": "<string>"
}
Attach notes to accounts and contacts. Use this to store context from conversations, meeting notes, lead source details, or any other info you want linked to a record.

Request

X-API-Key
string
required
Your Octolane API key.
Content-Type
string
required
Must be application/json.

Body parameters

note
object
required
The note content.
account_domains
string[]
Array of company domains to attach the note to (e.g., ["acme.com"]).
contact_emails
string[]
Array of contact emails to attach the note to (e.g., ["john@acme.com"]).
Include at least one of account_domains or contact_emails so the note is attached to a record. You can include both to link the note to both the company and the person.

Example request

curl -X POST "https://enrich.octolane.com/v1/inbound/notes" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "note": {
      "title": "Instantly Lead - First Contact",
      "content": "Reached out via cold email. Replied interested in demo."
    },
    "account_domains": ["acme.com"],
    "contact_emails": ["john@acme.com"]
  }'

Response

success
boolean
Whether the request succeeded.
data
object
message
string
Human-readable status message.
200
{
  "success": true,
  "data": {
    "note_id": "bb0e8400-e29b-41d4-a716-446655440000",
    "title": "Instantly Lead - First Contact",
    "content": "Reached out via cold email. Replied interested in demo."
  },
  "message": "Note created successfully"
}

Common use cases

Storing outbound context. When a lead from Instantly or Apollo replies, push the conversation context into Octolane as a note so your agents have full history. Meeting notes via API. After a call, push a summary note attached to the contact and account. Lead source tagging. Use the note title or content to tag where a lead came from (e.g., “Source: Instantly Cold Campaign Q1”).